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:

  1. You call MoneyInSddInit to request a direct debit
  2. Lemonway sends the request to the bank at 10:30 a.m. or on the following working day at 10:30 a.m. (CET).
  3. 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)
  4. When Lemonway receives the payment, the SDD payment is validated and the Client Wallet will be credited
  5. 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

ElementDescriptionRequiredFormatExample
walletThe payment account ID to creditYes[0: 256] char33612345678 or taxi67
amountTotAmount to debit from the client's bank accountYes2 decimals15
amountComAmount of the fees you want to keepNo2 decimals1
commentCommentNo[0:140] char245
autoCommissionIndicates if you want automatic fee calculationYes[1] char0: no (default)
sddMandateIdThe mandate IDYesinteger356
collectionDateThe debit date of the bank account must be later than the default date.Nodd/mm/yyyy21/03/2015

Response Output Description

ElementDescriptionExample
IDThe transaction ID677
MLABELNot used
DATEInitialization date18/06/2014 16:11:10
RECPayment account to creditPizza56
DEB0.00 in this case0
CREDAmount to credit (total minus fee)15
COMYour fee2
MSGComment245
STATUSAlways 0: pending0