API Reference Docs
OnboardingAPI v1ChangelogAPI Status
Start typing to search…

Request a SEPA Direct Debit (SDD)

post
https://sandbox-api.lemonway.fr/mb/ENV-NAME/directkitrest/v2/moneyins/sdd/init

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.

Use this endpoint to initiate SEPA Direct Debits, which are submitted to the bank every business day at 10:30 AM CET.

Prerequisites

  1. Collect and pre‑register your client’s mandate via POST /moneyins/sdd/mandate.
  2. Complete the electronic-signature flow with POST /documents/{documentid}/signinit.

Request flow

  1. Call POST /moneyins/sdd/init to schedule a debit.
  2. Each business day at 10:30 AM CET, Lemonway forwards all pending DD requests to the bank.
  3. The client’s account is debited ~1 business day later (or on the specified date if you included one).
  4. When funds arrive, Lemonway validates the payment and credits the client’s payment account.
  5. Query GET /moneyins/sdd (daily) or use notifications to see which payments have been validated.

Special rule for Italian IBANs

  • Only the first B2B Direct Debit on an Italian IBAN incurs a ~14‑day mandate‑validation period. Even if you request an earlier date, the actual debit happens 14 calendar days after submission.
  • All subsequent debits on that IBAN follow the standard 1–2 business‑day schedule.

Example

  • Submission: March 30, 2022 (before 10:30 AM CET), requested debit date April 4, 2022
  • Actual debit date: April 18, 2022 (14 days after request)

Important: Whenever you see accountId in a path or body parameter, enter your wallet’s ID.

Language
Click Try It! to start a request and see the response here!