Bancontact via Worldpay

​

Supported workflows

​

Before you begin

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

​

Request fields for Worldpay

​

Authorize a Bancontact payment

{
  "amount": {
    "value": "25.00",
    "currency": "EUR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "bancontact",
      "amount": {
        "value": "25.00",
        "currency": "EUR"
      }
    }
  ],
  "meta": {
    "order": {
      "reference": "order-1234",
      "softDescriptor": "Example Store",
      "billingAddress": {
        "email": "lotte.peeters@example.com",
        "country": {
          "code": "BE"
        }
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Worldpay handles Bancontact

• Payrails reads the customer’s email from meta.order.billingAddress.email, not from meta.customer.email.
• When Worldpay reports the payment as pending after the redirect, Payrails waits for the Worldpay webhook to set the final status.
• Bancontact through Worldpay supports customer-initiated transactions (CIT): the customer confirms every payment.