In test mode: we won't validate the SDD. Instead, please use the Backoffice to validate it manually.

Version	Description
1.0

How it works

SDD requests are sent to our bank every working day at 10:30.

Prerequisites:

You allow your client to fill in a mandate, and pre-register it with Lemonway, by calling RegisterSddMandate
Follow the SignDocumentInit process in order to electronically sign the mandate

Request the direct debit:

You call MoneyInSddInit to ask for a debit
Lemonway sends the request to the bank every working day at 10:30, Paris time.
Once the request is sent to the bank, the actual debit on the client's bank account will happen about 1 working day later. If you indicate a date, the debit will happen on the given date.
When Lemonway receives the payment, the SDD payment will be validated and the Client Wallet will be credited
You can call GetMoneyInSdd once a day in order to know which payments have been validated. You can also use our notification functionality.

Request

XML

<MoneyInSddInit xmlns="Service_mb">
  <wlLogin>string</wlLogin>
  <wlPass>string</wlPass>
  <language>string</language>
  <version>string</version>
  <walletIp>string</walletIp>
  <walletUa>string</walletUa>
  <wallet>string</wallet>
  <amountTot>string</amountTot>
  <amountCom>string</amountCom>
  <comment>string</comment>
  <autoCommission>string</autoCommission>
  <sddMandateId>string</sddMandateId>
  <collectionDate>string</collectionDate>
</MoneyInSddInit>

JSON

{   
    "wlLogin":"string",
    "wlPass":"string",
    "language":"string",
    "version":"string",
    "walletIp":"string",
    "walletUa":"string",
    "wallet":"string",
    "amountTot":"string",
    "amountCom":"string",
    "comment":"string",
    "autoCommission":"string",
    "sddMandateId":"string",
    "collectionDate":"string"
}

Element	Description	Required	Format	Example
wallet	ID of the payment account to credit	Yes	[0 : 256] char	33612345678 or taxi67
amountTot	Amount to debit from the client's bank account	Yes	2 decimals	15.00
amountCom	Amount of the fees you want to keep	No	2 decimals	1.00
comment	Comment	No	[0 :140] char	245
autoCommission	Tells if you want us to automatically calculate the correct fee to get from the client. If yes: [amountTot] will be debited from the bank account, [payment account] will receive [amounTot- Lemonway's automatic fee], and you will not receive any fee	Yes	[1] char	0: no (default) 1: yes
sddMandateId	ID of the mandate	Yes	integer	356
collectionDate	Debit date of the bank account must be later than the default date. Leave empty in order to use the default date: current date + 1 working days before 10:30 AM or current date + 2 working days after.	No	dd/mm/yyyy	21/03/2015

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>
	</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"
    }
  }
}

Element	Description	Example
ID	ID of the transaction	677
MLABEL	Not used
DATE	Initialization date	18/06/2014 16:11:10
SEN	Not used
REC	Payment account to credit	Pizza56
DEB	0.00 in this case	0.00
CRED	Amount to credit (total minus your fee)	15.00
COM	Your fee	2.00
MSG	Comment	245
STATUS	Always 0: pending	0

MoneyInSddInit: Request a Direct Debit (SDD)

How it works

Prerequisites:

Request the direct debit:

Request

Answer

Search