Integration

Overview

Flow

The SEPA Direct Debit transaction starts by sending the request for a direct debit to the BPE transaction gateway. The gateway processes the request and sends a response to the merchant. Additionally, a transaction push can be sent to the merchant as well (both contain the current status of the transaction). The Payment Engine will then perform the direct debit on the account of the customer. This will take a few days and will either fail or succeed, after which the status is again pushed to the merchant site. If it succeeds, it is still possible that at a later point a reversal occurs. This will create a new transaction with a credit amount to deduct the previous amount from the merchant account. Again, this status is pushed to the merchant site.


Mandates

SEPA Direct Debit requires a merchant to obtain a mandate from a customer to be allowed to perform a direct debit. A reference to this mandate and the signing date of the mandate is then used for all direct debits.


Recurring SEPA Direct Debits

  • It is possible to perform multiple direct debits using the same mandate.
  • The mandate must mention that it is given for recurring direct debits.
  • The first transaction needs to be performed separately and needs to have the flag "StartRecurrent" set to true.
  • The follow-up recurring transactions need to reference this original transaction.
  • The maximum period between two recurring transactions is 36 months. (After 36 months of not using a mandate, it expires).

Notification of a Direct Debit

To have the Payment Engine send a notification to the consumer, notifying the consumer of an impending direct debit, add the supplementary Notification service with the action ExtraInfo to the request. Also, use the notification type ‘PreNotification’.


Reversals and Rejects

  • Direct debits may initially appear to succeed, but after a few days, they may fail due to insufficient funds or account blocking.
  • Consumers can contact their bank to reverse a specific direct debit.
  • In all cases, a reversal transaction is created to correct the merchant balance on the Buckaroo account.
  • If a reversal occurs 56 days or more after the original transaction, there are additional bank costs.

📘

Note

In the case a reversal occurs 56 days or more after the original transaction, a reversal and also a MOI transaction are created. The transaction type of the MOI transaction is an informational transaction. This informational transaction has no influence on the balance since this is only a registration for the additional bank costs. MOIs cannot happen if the direct debit transaction was created in combination with an e-mandate. This is only possible for SEPA Direct Debit if you are using the ExtraInfo action to also send the mandate reference. For information on e-mandates, see the e-mandate manual. If you wish to use the e-mandate service, contact Buckaroo’s sales department.


Service Codes and Actions

  • Service Code: sepadirectdebit (b2c) or sepadirectdebitb2b (b2b).
  • Supported Actions: Pay, Refund, ExtraInfo, PayRecurrent, Authorize.
    • For Refund and Authorize use channel 'Backoffice'.
    • The rest uses channel 'Web' (default).