MoneyInSubscriptionInit : Initiate Monthly Recurring Payments

Version

Description

1.0


1.1

Output: add an EXTRA tag with additional information

How does it work?

  1. Initiate the first transaction
    1. If you are using the PSP Payment Page, you need to have initiated a Web Payment using MoneyInWebInit with Registercard = 1 
    2. If you are using the Direct Mode (PCI-DSS authorization required), you need to have registered a Card using RegisterCard

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

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:

  • [amountCom] will be ignored and will be replaced with Lemonway's fee

  • You will not receive any fee

No

[1] char

0: No (by default) 
1: Yes

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 :

  • 0 if no
  • 1 if yes

1

>= 1.1

EXTRA.CTRY

The country that emitted the card

FRA

>= 1.1

EXTRA.AUTH

Authorization number

43245