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.

🚧

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 did memorize its card on your website, and use someone else card to pay on your website.

📘

Please note

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 MandatoryFormat Example
walletWallet IDYes[0: 256] char33612345678 ou taxi67
cardTypeCard TypeYes[1:1] char0: CB
1: Visa
2: Mastercard
cardNumberCard numberYes[13:19] char4.972E+15
cardCodeCVV code on the back of the cardYes[3: 4] char123
cardDateCard expiration dateYes[7] charJun-13
specialConfigLeave emptyNo[0 : max] char

Response Output Description

VersionItemDescriptionExample
>= 1.0IDMemorized card token for further use (rebill)255
>= 1.2EXTRAExtra data
>= 1.2EXTRA.IS3DSIndicates if the transaction was 3D Secure:0
Always 0 in this case
>= 1.2EXTRA.CTRYCard issuing countryFRA
>= 1.2EXTRA.AUTHAuthorization number43245
>= 1.2EXTRA.NUMCard number4646XXXXXXXX78
>= 1.2EXTRA.EXPExpiration date MM/YYYYMar-16