Register a Card for Direct Payments (PCI-DSS compliant only)
ImportantThis 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 |