Request a SEPA Direct Debit (SDD)

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

  1. You allow your client to fill in a mandate, and pre-registers it with Lemonway, by calling POST /moneyins/sdd/mandate
  2. Follow the SignDocumentInit process in order to electronically sign the mandate
    Request the direct debit:
  3. You call POST /moneyins/sdd/init to request a debit
  4. Lemonway sends the request to the bank every working day at 10:30am (CET).
  5. Once the request is sent to the bank, the debit on the client's bank account will happens about 1 working day later. If you indicate a date, the debit will happen on the given date.
  6. When Lemonway receives the payment, the SDD payment will be validated and the client payment account will be credited
  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.
    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.
Body Params
int64
required

Mandate ID

string

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.

string
length between 0 and 50

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

string
required
length between 0 and 256

Payment Account ID to Credit

int32

Amount to Debit Amounts are given as integer numbers in cents

int32

Your Fee Amounts are given as integer numbers in cents

string
length between 0 and 140

Comment Regarding the Transaction

boolean

If true:

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

Authorization bearer (OAuth 2)

string

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

string
required

IP address of the final client (PSU).

string

User-agent of the final client (PSU).

Responses

401

Unauthorized

500

InternalServerError

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json