Sepa Direct Debit

Overview

Accepting SEPA Direct Debit payments on your website consists of:

Creating an object to track a payment;

Collecting payment method information;

Mandate acknowledgment;

Submitting the payment to WooshPay for processing.

WooshPay uses this payment object, the PaymentIntent, to track and handle all the states of the payment until the payment completes.

SEPA direct debit transactions have a limit of 1,000 EUR each.

Integration Method

Checkout

1. Determine compatibility

To support SEPA Direct Debit payments in Checkout, Prices for all line items must be expressed in Euro (currency code eur).

Available country codes
EU countries	AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, ES, SE
EEA Countries	IS, LI, NO
Countries that have bilateral agreements with EU	AD, SM, MC, VA
Other SEPA-supporting countries (supported EUR-denominated accounts only)	PF, TF, GI, GG, IM, JE, BL, PM, CH, GB, WF
-----------------------
Supported currencies	eur
Presentment currencies	eur

2. Accept a payment

Use this guide to learn how to enable SEPA Direct Debit—it shows the differences between accepting a card payment and using SEPA Direct Debit.

Enable SEPA Direct Debit as a payment method
When creating a new Checkout Session, you need to:

Add sepa_debit to the list of payment_method_types.

Make sure all your line_items use the eur currency.

Integration Method

Server to Server

1. Create a PaymentIntent

A PaymentIntent is an object that represents your intent to collect payment from a customer and tracks the lifecycle of the payment process through each stage.
First, create a PaymentIntent on your server and specify the amount to collect and the eur currency (SEPA Direct Debit does not support other currencies).
If you already have an integration using the Payment Intents API, add sepa_debit to the list of payment method types for your PaymentIntent.

Request

{
    "amount": 2000,
    "currency": "EUR",
    "confirm": true,
    "payment_method_options": {
        "sepa": {
            "iban": "DE12500105170648489890"
        }
    },
    "payment_method_data": {
        "type": "sepa",
        "billing_details": {
            "address": {
                "country": "DE"
            },
            "email": "john.doe@fake.id",
            "name": "John Doe"
        }
    },
    "return_url": "https://wooshpay.com"
}

2. Test your integration

Wooshpay provides test numbers you can use to make sure your integration is ready for production.

Use the SEPA Direct Debit test numbers when testing your Checkout integration with SEPA Direct Debit.

Test IBAN: DE12500105170648489890

Overview#

#

Integration Method#

Checkout#

1. Determine compatibility#

#

#

2. Accept a payment#

Integration Method#

Server to Server#

1. Create a PaymentIntent#

#

2. Test your integration#

Overview

Integration Method

Checkout

1. Determine compatibility

2. Accept a payment

Integration Method

Server to Server

1. Create a PaymentIntent

2. Test your integration