Request a Direct Debit (SDD)
MoneyInSddInit
In test mode
We won't validate the SDD. Instead, please use the Backoffice (Dashboard) to validate it manually.
How it works
Important
SDD requests are sent to our bank every working day at 10:30am (CET). Please consult this page to learn about the submission deadline.
Prerequisites:
You allow your client to fill in a mandate, and pre-register it with Lemonway, by calling Register a SDD Mandate
Follow the SignDocumentInit process in order to electronically sign the mandate
Request the direct debit:
- You call MoneyInSddInit to request a direct debit
- Lemonway sends the request to the bank at 10:30 a.m. or on the following working day at 10:30 a.m. (CET).
- Once the request is sent to the bank, the end-user account is debited one work day later. If you indicate a date, the debit will happen on the given date. (See Important note below if you bank in Italy)
- When Lemonway receives the payment, the SDD payment is validated and the Client Wallet will be credited
- You can call List of money-in by SDD once a day to know which payments have been validated.
Important: Italian bank mandate process
This rule only applies to the first B2B direct debit request for an Italian IBAN. Subsequently, all future debits take place within the standard 1-2 day time frame. The mandate validation process for Italian banks takes approximately 14 calendar days from the reception of the first SDD request. Even if you initially specify a debit date, the funds will only be debited 14 days after the request date.
Example: If you specify that you would like the first Direct Debit to take place on 4th April 2022 and you submit a request before 10:30am (CET) on the 30th March 2022. The direct debit will take place on 18th April 2022.
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>
<?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
{
"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"
}
{
"TRANS": {
"HPAY": {
"ID": "string",
"MLABEL": "string",
"DATE": " string ",
"SEN": " string",
"REC": "string",
"DEB": "string",
"CRED": "string",
"COM": "string",
"MSG": "string",
"STATUS": "string"
}
}
}
Request Input Description
Element | Description | Required | Format | Example |
---|---|---|---|---|
wallet | The payment account ID to credit | Yes | [0: 256] char | 33612345678 or taxi67 |
amountTot | Amount to debit from the client's bank account | Yes | 2 decimals | 15 |
amountCom | Amount of the fees you want to keep | No | 2 decimals | 1 |
comment | Comment | No | [0:140] char | 245 |
autoCommission | Indicates if you want automatic fee calculation | Yes | [1] char | 0: no (default) |
sddMandateId | The mandate ID | Yes | integer | 356 |
collectionDate | The debit date of the bank account must be later than the default date. | No | dd/mm/yyyy | 21/03/2015 |
Response Output Description
Element | Description | Example |
---|---|---|
ID | The transaction ID | 677 |
MLABEL | Not used | |
DATE | Initialization date | 18/06/2014 16:11:10 |
REC | Payment account to credit | Pizza56 |
DEB | 0.00 in this case | 0 |
CRED | Amount to credit (total minus fee) | 15 |
COM | Your fee | 2 |
MSG | Comment | 245 |
STATUS | Always 0: pending | 0 |