MoneyInSubscriptionInit : Initiate Monthly Recurring Payments
Version | Description |
---|---|
1.0 | |
1.1 | Output: add an EXTRA tag with additional information |
How does it work?
- Initiate the first transaction
- If you are using the PSP Payment Page, you need to have initiated a Web Payment using MoneyInWebInit with Registercard = 1
- If you are using the Direct Mode (PCI-DSS authorization required), you need to have registered a Card using RegisterCard
- You then need to initiate MoneyInCardSubscriptionInit specifying the cardId returned from the first transaction, and the subscriptionId (a unique reference you indicate for this subscription). You will also need to precise about the number of Recurring Payments you want us to initiate in the count. The amountTot corresponds to the amount of each recurring payment. By default, the payment will be processed 15th of the month.
- We will create scheduled transactions in the back office (status 14)
- On each payment execution date, Lemonway will debit the card and change the pending transaction status to success, and then notify you.
Request
XML
<MoneyInSubscriptionInit xmlns="Service_mb">
<wlLogin>string</wlLogin>
<wlPass>string</wlPass>
<language>string</language>
<version>string</version>
<walletIp>string</walletIp>
<walletUa>string</walletUa>
<wallet>string</wallet>
<cardId>string</cardId>
<amountTot>string</amount>
<amountCom>string</amountCom>
<comment>string</comment>
<autoCommission>string</autoCommission>
<subscriptionId>string</subscriptionId>
<count>string</count>
</MoneyInSubscriptionInit>
JSON
{
"wlLogin": "string",
"wlPass": "string",
"language": "string",
"version": "string",
"walletIp": "string",
"walletUa": "string",
"wallet": "string",
"cardId": "string",
"amountTot": "string",
"amountCom": "string",
"comment": "string",
"autoCommission": "string",
"subscriptionId": "string",
"count": "string"
}
Element | Description | Requis | Format | Exemple |
---|---|---|---|---|
wallet | Payment account ID to credit | Yes | [0 : 256] char | 33612345678 ou taxi67 |
cardId | Id of the card linked to the payment account | Yes | entier | 243 |
amountTot | Amount to debit from card | Yes | 2 decimals | 15.00 |
amountCom | Your fee | No | 2 decimals | 1.00 |
comment | Comment regarding the transaction | No | [0 :140] char | Order 245 |
autoCommission | If Yes:
| No | [1] char | 0: No (by default) |
subscriptionId | Subscription ID | Yes | [0 : 24] char | 0023T400 |
count | Number of operations to be performed on this subscription | Yes | entier | 4 |
Answer
XML
<?xml version="1.0" encoding="utf-8"?>
<TRANS>
<HPAY>
<ID>string</ID>
<MLABEL>string</MLABEL>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
<EXTRA> <!--à partir de la version 1.1 -->
<IS3DS>string</IS3DS>
<CTRY>string</CTRY>
<AUTH>string</AUTH>
</EXTRA>
</HPAY>
<HPAY>
<ID>string</ID>
<MLABEL>string</MLABEL>
<DATE> string </DATE>
<SEN> string </SEN>
<REC> string </REC>
<DEB> string </DEB>
<CRED> string </CRED>
<COM> string </COM>
<MSG> string </MSG>
<STATUS> string</STATUS>
<EXTRA> <!--à partir de la version 1.1 -->
<IS3DS>string</IS3DS>
<CTRY>string</CTRY>
<AUTH>string</AUTH>
</EXTRA>
</HPAY>
....
</TRANS>
JSON
{
"TRANS":{
"HPAY":{
"ID":"string",
"MLABEL":"string",
"DATE":" string ",
"SEN":" string ",
"REC":" string ",
"DEB":" string ",
"CRED":" string ",
"COM":" string ",
"MSG":" string ",
"STATUS":" string",
"EXTRA":{
"IS3DS":"string",
"CTRY":"string",
"AUTH":"string"
}
"HPAY":{
"ID":"string",
"MLABEL":"string",
"DATE":" string ",
"SEN":" string ",
"REC":" string ",
"DEB":" string ",
"CRED":" string ",
"COM":" string ",
"MSG":" string ",
"STATUS":" string",
"EXTRA":{
"IS3DS":"string",
"CTRY":"string",
"AUTH":"string"
}
....
}
}
}
Version | Element | Description | Exemple |
---|---|---|---|
1.0 | ID | Request ID | 255 |
1.0 | MLABEL | Hidden card number | XXXX XXXX XXXX 9854 |
1.0 | DATE | Request date | 10/09/2011 18:09:27 |
1.0 | SEN | Empty in this case | |
1.0 | REC | Beneficiary payment account | Pizza56 |
1.0 | DEB | 0.00 in this case | 0.00 |
1.0 | CRED | Amount to be credited on payment account (minus your fee) | 15.00 |
1.0 | COM | Your fee | 2.00 |
1.0 | MSG | Comment | Order 245 |
1.0 | STATUS | 14 : scheduled | 14 |
>= 1.1 | EXTRA | Tag with additional information | |
>= 1.1 | EXTRA.IS3DS | IS transaction has been 3DSecured :
| 1 |
>= 1.1 | EXTRA.CTRY | The country that emitted the card | FRA |
>= 1.1 | EXTRA.AUTH | Authorization number | 43245 |