RegisterCard

Register a Card for Direct Payments (PCI-DSS compliant only)

Important

This method has been deprecated. If you would like to register a clients card for future payments use [Initiate a Direct Payment (PCI-DSS compliant only) and set registerCard=1 in the method parameters.

How it works

Register a card and associate it with a Payment Account. The end-user does not have to re-enter their card details for future payments.

Ensure the login on your website is secured enough to avoid phishing. Someone else could log on to your website, pretend to be a customer that did memorize its card on your website, and use someone else card to pay on your website.

Lemonway does not recommend you use the MoneyIn method from January 2021. You should now use [Initiate a Direct Payment (PCI-DSS compliant only) and Money-In - By Card ] only

XML

<RegisterCard xmlns="Service_mb">
  <wlLogin>string</wlLogin>
  <wlPass>string</wlPass>
  <language>string</language>
  <version>string</version>
  <walletIp>string</walletIp>
  <walletUa>string</walletUa>
  <wallet>string</wallet>
  <cardType>string</cardType>
  <cardNumber>string</cardNumber>
  <cardCode>string</cardCode>
  <cardDate>string</cardDate>
  <specialConfig>string</specialConfig>
</RegisterCard>

<?xml version="1.0" encoding="utf-8"?>
<CARD>
    <ID>String</ID>
    <EXTRA> <!--since version 1.2 -->
        <IS3DS>string</IS3DS>
        <CTRY>string</CTRY>
        <AUTH>string</AUTH>
        <NUM>string</NUM>
        <EXP>string</EXP>
    </EXTRA>
</CARD>

JSON

{   
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "wallet":"string",
    "cardType":"string",
    "cardNumber":"string",
    "cardCode":"string",
    "cardDate":"string",
    "specialConfig":"string"
}

{  
    "CARD":{  
        "ID":"String",
        "EXTRA":{  
            "IS3DS":"string",
            "CTRY":"string",
            "AUTH":"string",
            "NUM":"string",
            "EXP":"string"
        }
    }
}

Request Input Description


Item	Description	Mandatory	Format	Example
wallet	Wallet ID	Yes	[0: 256] char	33612345678 ou taxi67
cardType	Card Type	Yes	[1:1] char	0: CB
				1: Visa
				2: Mastercard
cardNumber	Card number	Yes	[13:19] char	4.972E+15
cardCode	CVV code on the back of the card	Yes	[3: 4] char	123
cardDate	Card expiration date	Yes	[7] char	Jun-13
specialConfig	Leave empty	No	[0 : max] char

Response Output Description

Version	Item	Description	Example
>= 1.0	ID	Memorized card token for further use (rebill)	255
>= 1.2	EXTRA	Extra data
>= 1.2	EXTRA.IS3DS	Indicates if the transaction was 3D Secure:	0
		Always 0 in this case
>= 1.2	EXTRA.CTRY	Card issuing country	FRA
>= 1.2	EXTRA.AUTH	Authorization number	43245
>= 1.2	EXTRA.NUM	Card number	4646XXXXXXXX78
>= 1.2	EXTRA.EXP	Expiration date MM/YYYY	Mar-16