SEPA Direct Debit

Server-Side Implementationanchor

important

Your integration may be impacted by upcoming certificate changes. Visit our best practices guide to learn more.

note

Ruby 2.104.1 or higher is required to use SEPA Direct Debit.

Creating transactionsanchor

Creating a SEPA Direct debit transaction is the same as creating any other transaction with a nonce or a vaulted payment method. Be sure to pass the device data you collected on the client side when you create the transaction.

Optional fieldsanchor

  • order_id - a merchant-generated ID associated with the transaction
  • descriptor_name - a descriptor that will show in the user's bank statement

Below includes an example call with relevant parameters:

  1. Ruby
result = gateway.transaction.sale(
  :amount => "10.00",
  :payment_method_nonce => nonce_from_the_client,
  :merchant_account_id => "EUR-merchant-account",
  :order_id => "Order 1234",
  :descriptor_name => "Merchant ABC",
  :device_data => device_data,
  :options => {
    :submit_for_settlement => true, # Required
  }
)
if result.success?
  "Success ID: #{result.transaction.id}"
else
  result.message
end

Currency supportanchor

SEPA Direct Debit only supports EUR currency.

SEPA Direct Debit webhooksanchor

You can set up webhooks to notify you of changes in status to SEPA Direct Debit transactions.


Next Page: Vaulting