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

RegisterCard

🚧
Important
This method has been deprecated. If you would like to register a client's 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.

🚧
Warning
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 memorized their card on your website, and use someone else's card to pay on your website.

📘
Please note
Lemonway does not recommend using 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	4972XXXXXXXXXXXX
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