Bancontact via Checkout.com

​

Supported workflows

​

Before you begin

1. Set up a Checkout.com integration in your workspace. Follow the Checkout.com integration setup guide if you don’t have one yet.
2. Ask Checkout.com support to enable Bancontact on your Checkout.com account.
3. In the Payrails Portal, go to Settings → Integrations, open your Checkout.com integration, select Bancontact under Payment methods, and save.
4. Add Bancontact as a payment option in your workflow.

​

Request fields for Checkout.com

​

Authorize a Bancontact payment

{
  "amount": {
    "value": "25.00",
    "currency": "EUR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "bancontact",
      "amount": {
        "value": "25.00",
        "currency": "EUR"
      }
    }
  ],
  "meta": {
    "customer": {
      "email": "lotte.peeters@example.com",
      "name": "Lotte",
      "lastName": "Peeters",
      "country": {
        "code": "BE"
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Checkout.com handles Bancontact

• Payrails processes Bancontact through the Checkout.com Payment Setup API. It creates a payment setup, confirms it and passes on the redirect that Checkout.com returns.
• Payrails joins meta.customer.name and meta.customer.lastName into the account holder name. When the full name is shorter than three characters, Payrails returns an error before it calls Checkout.com.
• Payrails doesn’t save the Bancontact payment method at Checkout.com, so Save Instruments and MIT aren’t available.