Sign in

v1

latestOpenAPI 3.0.02026-07-2691259477.2 KB
MoneyIns | Direct Debits

Request a SEPA Direct Debit (SDD)

SEPA Direct Debit requests are sent to our bank every working day at 10:30am (CET).<br /> Prequisites:<br />

  1. You allow your client to fill in a mandate, and pre-registers it with Lemonway, by calling POST /moneyins/sdd/mandate<br />
  2. Follow the SignDocumentInit process in order to electronically sign the mandate<br /> Request the direct debit:<br />
  3. You call POST /moneyins/sdd/init to request a debit<br />
  4. Lemonway sends the request to the bank every working day at 10:30am (CET).<br />
  5. Once the request is sent to the bank, the debit on the customer's bank account will happens about 1 working day later. If you indicate a date, the debit will happen on the given date.<br />
  6. When Lemonway receives the payment, the SDD payment will be validated and the client payment account will be credited<br />
  7. You can call GET /moneyins/sdd once a day in order to know which payments have been validated.You can also use our notification functionality.<br /> Important: Setting up an SDD with Italian Banks. This rule only applies to the first B2B direct debit request for an Italian IBAN.
    Thereafter, 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.
post/v2/moneyins/sdd/init

Headers

Authorizationstring required

Authorization bearer (OAuth 2)

PSU-Accept-Languagestring

Response language accepted by final client (PSU). English by default

PSU-IP-Addressstring required

IP address of the final client (PSU).

PSU-User-Agentstring

User-agent of the final client (PSU).

Request body

sddMandateIdinteger

Mandate ID

collectionDatestring

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.

referencestring

Unique ID of the call, generated by your server. This ID can be used as a search field when looking for operation details

accountIdstring required

Payment Account ID to Credit

totalAmountinteger required

Amount to Debit Amounts are given as integer numbers in cents

commissionAmountinteger

Your Fee Amounts are given as integer numbers in cents

commentstring

Comment Regarding the Transaction

autoCommissionboolean

If true:

  1. [amountCom] will be ignored and will be replaced with Lemonway's fee
  2. You will not receive any fee

Example request

{
  "sddMandateId": 356,
  "collectionDate": "2026/07/02",
  "reference": "Dze8778",
  "accountId": "33612345678",
  "totalAmount": 1500,
  "commissionAmount": 100,
  "comment": "Order number 2457765AX2",
  "autoCommission": false
}

Response

OK