On This Page
Bancontact
Bancontact enables customers to make secure online and in-store purchases directly from
their bank accounts. Bancontact is a leading payment method in Belgium.
When the total amount of the order is outside the range of accepted transaction amounts,
the Bancontact payment button is not displayed in
Unified Checkout
. These
are the accepted transaction amounts:- Minimum transaction amount: EUR 0.01
- Maximum transaction amount: Not applicable
Billing Details for Bancontact
The
captureMandate.billingType
field value determines whether
Unified Checkout
displays the full billing details form when
Bancontact requires partial billing details.When the
captureMandate.billingType
field is set to
FULL
and Bancontact requires partial billing details,
Unified Checkout
displays the full billing details form.- If the merchant includes all required fields in the capture context request, and the billing country is compatible with the payment type, the consumer currency, or both, the consumer sees a billing summary confirmation screen.
- If the merchant does not include all required fields in the capture context request, the consumer sees the full billing details form.
When the
captureMandate.billingType
field is set to
PARTIAL
and Bancontact requires partial billing details,
Unified Checkout
displays the full billing details form.- If the merchant includes all required fields in the capture context request, and the billing country is compatible with the payment type, the consumer currency, or both, the consumer sees a billing summary confirmation screen.
- If the merchant does not include all required fields in the capture context request, the consumer sees the full billing details form.
Opt in to Bancontact on Unified Checkout
Unified Checkout
You can enable Bancontact from the
Unified Checkout
merchant experience
section in the Business Center
. For information about how to enable
Bancontact using the Business Center
, see Configure Payment Options.You can also enable Bancontact using the
Unified Checkout
v1/sessions
API. Follow these steps to opt in to the Bancontact
payment method using the API: - Add Bancontact to your integration by addingBANCONTACTto theallowedPaymentTypesfield object within the capture context request.
- Set thecompleteMandate.typefield value toCAPTUREorPREFER_AUTH.You can capture the funds immediately if you include thecompleteMandate.typefield in the capture context request and set the value toCAPTURE.If you support more than one payment type and must perform an authorization where funds are collected at a later time, set thecompleteMandate.typefield toPREFER_AUTH. The funds will be captured immediately for the online bank transfer.
- Include these required fields for online bank transfers in the capture context request:
- data.orderInformation.billTo.country
- data.orderInformation.billTo.firstName
- data.orderInformation.billTo.lastName
- Include this optional field for online bank transfers in the capture context request:
- data.orderInformation.billTo.address1
- data.orderInformation.billTo.email
IMPORTANT
When you do not include the billing and
shipping information in the capture context request, a pop-up will appear for
the merchant to provide this information during checkout.