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 | 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 |