Create Payment Instrument Mandate

Preview: This endpoint is a preview API and may change without a deprecation period.

Creates a SEPA Direct Debit mandate for the customer's bank account (the debtor account). The mandate is returned with status created and cannot be used for collections until it is confirmed via POST /accounts/{account_id}/payment_instrument_mandates/{payment_instrument_mandate_id}/confirm.

lemon.markets assigns the mandate_reference and the creditor data. Before confirmation, present the mandate to the customer together with the creditor and debtor data.

While the mandate is created, the response contains sca. When sca.required is true, the customer must sign sca.challenge with a registered authenticator and the signature must be sent when confirming the mandate.

A customer account can have at most one confirmed mandate per debtor bank account.

An event with type payment_instrument_mandate.created will be created.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

An account identifier.

Body Params
const
enum
required

The payment method of the mandate. Only sepa_direct_debit is supported.

Allowed:
debtor
object
required

The customer's bank account that the mandate authorizes collections from.

Headers
string
required
string
required
string
length ≤ 100

An optional idempotency key to safely retry requests without creating duplicate resources. Pass a unique string (UUID recommended, max 100 characters). Retrying with the same key returns the mandate created by the first request. For full details see the Idempotency guide.

Responses

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