Initiate Monthly Recurring Payments

MoneyInSubscriptionInit

How it works

  1. Initiate the first transaction

  2. You then need to Initiate Monthly Recurring Payments specifying the cardId returned from the first transaction, and the subscriptionId (a unique reference you indicate for this subscription). You will also need to indicate the number of Recurring Payments you want us to initiate in the count. The amountTot corresponds to the amount of each recurring payment. Please note that by default, recurrences will be collected on the 15th and the first transaction initiated the month following the day of this request.

  3. We will create scheduled transactions in the back office (status 14)

  4. On each payment execution date, Lemonway will debit the card and change the pending transaction status to success, and then notify you.

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>

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

{   
    "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"
} 
{  
    "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"
            }
....
        }
    }
}

Request Input Description

ElementDescriptionRequestFormatExample
walletPayment account ID to creditYes[0: 256] char33612345678 ou taxi67
cardIdCard ID linked to the payment accountYesentier243
amountTotAmount to debit from the cardYes2 decimals15
amountComYour feeNo2 decimals1
commentComment regarding the transactionNo[0:140] charOrder 245
autoCommissionIf Yes:No[1] char0: No (by default) 
[amountCom] will be ignored and will be replaced with Lemonway's fee1: Yes
You will not receive any fee
subscriptionIdSubscription IDYes[0: 24] char0023T400
countNumber of operations to be performed on this subscriptionYesentier4

Response Ouput Description

VersionElementDescriptionExample
1IDRequest ID255
1MLABELHidden card numberXXXX XXXX XXXX 9854
1DATERequest date10/9/2011 18:09
1SENEmpty in this case
1RECBeneficiary payment accountPizza56
1DEB0.00 in this case0
1CREDAmount to be credited to the payment account (minus your fee)15
1COMYour fee2
1MSGCommentOrder 245
1STATUS14: scheduled14
>= 1.1EXTRATag with additional information
>= 1.1EXTRA.IS3DSIS transaction has been 3DSecured :1
0 if no
1 if yes
>= 1.1EXTRA.CTRYThe country that emitted the cardFRA
>= 1.1EXTRA.AUTHAuthorization number43245