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:30 CET.

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 ask for a debit
  2. Lemonway sends the request to the bank every working day at 10:30, Paris time.
  3. 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.
  4. When Lemonway receives the payment, the SDD payment will be validated and the Client Wallet will be credited
  5. You can call List of money-in by SDD once a day in order to know which payments have been validated.

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
walletID of the payment account 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
autoCommissionTells if you want us to automatically calculate the correct fee to get from the client.Yes[1] char0: no (default)
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 fee1: yes
sddMandateIdID of the mandateYesinteger356
collectionDateDebit date of the bank account must be later than the default date.Nodd/mm/yyyy21/03/2015
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.

Response Output Description

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