MoneyInSubscriptionInit : Payment account credited with monthly subscription by card

Version

Description

1.0

1.1

Output: add EXTRA tag with additional information

How it works

This function allow partner to subscribe to monthly rebill operation.

  1. The WHITE BRAND (you) communicate to lemonway which is the date of the month they wish to make the monthly rebill
  2. The WHITE BRAND (you) call this function to configure
    1. Which is the card they want to rebill (parameter cardId)?
    2. How much is the amount and the comission (parameter amountTot and amoutCom)?
    3. How many times they want to perform monthly rebill (parameter count)
    4. ... (see the below parameter list for more information)
  3. LemonWay will initialize the subscription by creating the count pending transactions with different execution dates (monthly)
  4. On the execution date, LemonWay will debit (rebill) the card, switch the pending transaction to success and notify the WHITE BRAND.

Request

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

  
    "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

WHITE BRAND 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 LEMON WAY's fee

  • The WHITE BRAND 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 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> 
{  
    "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 payement account (minus WHITE BRAND fee)

15.00

1.0

COM

WHITE BRAND fee

2.00

1.0

MSG

Comment

Order 245

1.0

STATUS

3 : success
16 : preauthorized - to be validated

16

>= 1.1

EXTRA

tag with additional information

>= 1.1

EXTRA.IS3DS

IS transaction have been 3DSeured :

  • 0 if no
  • 1 if yes

1

>= 1.1

EXTRA.CTRY

Country that emitted the card

FRA

>= 1.1

EXTRA.AUTH

Authorization number

43245