Accept a Bancontact payment

Learn how to accept Bancontact, a common payment method in Belgium.

Web

Mobile

Caution

Stripe automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.

If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide (for example, to accept payments in Subscription mode). Otherwise, migrate to the dashboard.

Bancontact is a single use payment method where customers are required to authenticate their payment. Customers pay with Bancontact by redirecting from your website, authorizing the payment, then returning to your website where you get immediate notification on whether the payment succeeded or failed.

Note

Your use of Bancontact must be in accordance with our Bancontact Terms of Service.

Determine compatibility

A Checkout Session must satisfy all of the following conditions to support Bancontact payments:

Prices for all line items must be expressed in Euro (currency code eur).

Accept a payment

Note

Build an integration to accept a payment with Checkout before using this guide.

Use this guide to learn how to enable Bancontact—shows the differences between accepting a card payment and using Bancontact.

Enable Bancontact as a payment method

When creating a new Checkout Session, you need to:

Add bancontact to the list of payment_method_types
Make sure all your line_items use the eur currency.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'bancontact'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `bancontact`, all line items must have currency: eur
      currency: 'eur',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

Test your integration

There are no special test numbers required for Bancontact.

When testing your Checkout integration, select Bancontact as the payment method and click the Pay button.

Handle refunds and disputes

The refund period for Bancontact is up to 180 days after the original payment.

There is no dispute process—customers authenticate with their bank.

Accept a Bancontact payment

Caution

Note

Determine compatibility

Accept a payment

Note

Enable Bancontact as a payment method

Fulfill your orders

Test your integration

Handle refunds and disputes

See also