Last Updated: 09 July 2025 | Change Log
Bancontact is a payment institution operating in Belgium.
Make yourself familiar with our API Principles to ensure a resilient integration.
Product overview
Payment type | Country | Acceptance Currency | Settlement Currency | Recurring | Reversals | Partial Reversals | Reversals period | Disputes |
---|---|---|---|---|---|---|---|---|
Local card scheme | Belgium | EUR | EUR | ❌ |
|
| Up to 180 days | ❌ |
- Minimum transaction amount: 0.02 EUR
- Maximum transaction amount:
- 1.500 EUR on mobile app
- 5.000 EUR by bank
- Maximum amount for a single refund: 3.000 EUR
Get started using our API Reference and set your headers.
POST
https://try.access.worldpay.com/apmPayments
- Try
https://try.access.worldpay.com/apmPayments
- Live
https://access.worldpay.com/apmPayments
- Payload
- curl
- Python
- Java
- Node.js
- Go
- PHP
- Ruby
- C#
{ "transactionReference": "Memory265-13/08/1876", "merchant": { "entity": "default" }, "instruction": { "method": "bancontact", "value": { "amount": 250, "currency": "EUR" }, "narrative": { "line1": "MindPalaceLtd" }, "paymentInstrument": { "type": "direct", "country": "BE" }, "resultUrls": { "cancel": "https://worldpay.com/cancel", "pending": "https://worldpay.com/pending", "success": "https://worldpay.com/success" }, "customer": { "email": "moriarty@example.com" } } }
Used to route the request in Access Worldpay, created as part of on-boarding.
Object that contains the payment type and details.
Type of payment method
- alipay_cn
- alipay_hk
- bancontact
- blik
- euteller
- ideal
- klarna
- konbini
- multibanco
- mybank
- open_banking
- oxxo
- paypal
- paysafecard
- pix
- przelewy
- sepa
- safetypay
- trustly
- wechatpay
The value of the payment.
The amount in the lowest denomination of the currency e.g. pennies for GBP, cents for USD.
The supported ISO 4217 currency codes.
The description shown on your customer's bank statement for the payment.
Type of instruction
Your customer's language.
The URL your customer is redirected to, after a cancelled payment outcome.
The URL your customer is redirected to, after a failed payment outcome.
The URL your customer is redirected to, after a pending payment outcome.
The URL your customer is redirected to, after a successful payment outcome.
- an HTTP code 201
- a
paymentId
which is unique to the payment - we recommend storing the "id", as you can use it to manage the payment later - a url to redirect your customer to the APM provider to complete the payment
- a link to query the payment status
- an object which will give flow information such as
method
(e.g.bancontact
) and type (direct
) - a
commandId
generated by us identifying a single merchant interaction (e.g.cmdYNdIHBPJwbkjLiykzTx0
)
{
"paymentInstrument": {
"method": "bancontact",
"type": "direct"
},
"paymentId": "eyJrIjoiYXBtLXNlcnZpY2UtbG9jYWwiLCJsaW5rVmVyc2lvbiI6IjYuMC4wIn0=.BnnxxcMle38OazhwbF8J+4rtJi8CAq:Y3zUOn1dw6VWfvx:PHL5L0S+5ara5vz6ouV5yBmVUQCiSwQjs+1x5qJIJxAKWMWc2Mlb1doricEYlzsZIRIGCflvnYu1Ns8g1S0+66n6wCELiB9OHfX7cdDZM8QaH19DiFbmMAchPSTy3YhKhjHb7eU81eSTnCsB+em66NOYspir3PJsMwGsI7DgQG6H8RA6ud004Gi7UbmmWuCYako2x2qLNAoCkV0HeDe9tVGUUJ8RPRm2jMHH20eHV:lzKfpwhCpCj20XtN:CPsSI2e:sopgZlkbmyvzDIeWSIThE3J1pPGsapqefRFo:b1Rfx8XquR8u:dBYr5a70wYkewsxOvrYXmLip3Fvy7rdfTE9SB:F5xmui5ij57ItzoUGQqmhdlJEFtZOvawnk19rQ8+2IHhZzeukzTZ41bET6DfydrjX20ywVxbq2Jw==",
"lastEvent": "pending",
"_links": {
"self": {
"href": "https://try.access.worldpay.com/apmPayments/eyJrIjoiYXBtLXNlcnZpY2UtbG9jYWwiLCJsaW5rVmVyc2lvbiI6IjYuMC4wIn0=.BnnxxcMle38OazhwbF8J+4rtJi8CAq:Y3zUOn1dw6VWfvx:PHL5L0S+5ara5vz6ouV5yBmVUQCiSwQjs+1x5qJIJxAKWMWc2Mlb1doricEYlzsZIRIGCflvnYu1Ns8g1S0+66n6wCELiB9OHfX7cdDZM8QaH19DiFbmMAchPSTy3YhKhjHb7eU81eSTnCsB+em66NOYspir3PJsMwGsI7DgQG6H8RA6ud004Gi7UbmmWuCYako2x2qLNAoCkV0HeDe9tVGUUJ8RPRm2jMHH20eHV:lzKfpwhCpCj20XtN:CPsSI2e:sopgZlkbmyvzDIeWSIThE3J1pPGsapqefRFo:b1Rfx8XquR8u:dBYr5a70wYkewsxOvrYXmLip3Fvy7rdfTE9SB:F5xmui5ij57ItzoUGQqmhdlJEFtZOvawnk19rQ8+2IHhZzeukzTZ41bET6DfydrjX20ywVxbq2Jw=="
}
},
"_actions": {},
"redirect": "http://secure-test.worldpay.com/redirect?tokenId=dc9c308b-d56b-4823-968e-0f94b20d6b73",
"commandId": "cmdOl8x_MaK4TxcF3exdl5cL0"
}
Check out our API reference for the full error code schema.
Next steps