SEPA Direct Debit
Preselected Payment Method
In order to pre-select SEPA direct debit as a payment method you can send checkoutSettings.preSelectedPaymentMethod with value 'Sepadd' while calling the /checkouts endpoint. Otherwise, the customer can choose SEPA direct debit on our hosted payment page.
Single versus recurring direct debit
SEPA direct debit can be initiated as a one-off payment or as a recurring by sending the paymentMethodDetails.sepaDirectDebit.transactionSequenceType object with one of the following values:
- SINGLE - to be used for one-off payment
- FIRST_COLLECTION - to be used for first payment out of a recurring series
If no value is provided, then the default value 'SINGLE' will be applied.
For subsequent recurring direct debits you can use our RESTful payments API. More details can be found here: link
Mandate
You can either collect the mandate reference on your own or let our gateway generate the mandate during the checkout process. In order to send the mandate details while calling the /checkouts endpoint, you will need to use the following elements under the paymentMethodDetails.sepaDirectDebit object:
| Field | Type | Description |
|---|---|---|
mandateReference | C | Reference to the mandate if you have created it. Must match [A-Za-z0-9:?/+(),. -]{1,35} and not start with two slashes ("//"). Also known as the mandate ID. |
signatureDate | C | Date of SEPA mandate signature if you have created it. Format: YYYY-MM-DD |
mandateReferenceUrl | O | Valid URL pointing to the SEPA mandate (PDF / HTML format recommended). |
Updated about 15 hours ago
