The general integration of Bancontact can be done either via the Payment Page, or the Transaction Interface and does not require any special attention, besides what is mentioned in the respective chapters.
Furthermore, for other flows (Refunds etc.), please also refer to the table above.
Bancontact Secure Card Data aliases may only be used for "card on file" 3D Secure transactions.
Bancontact Direct Mode
The Bancontact Direct Mode allows the merchant to directly integrate Bancontact into their site or mobile app. This chapter handles the technical details and flow of this type of integration.
(click to enlarge)
First, the merchant's application initiates the payment via the Transaction AlternativePayment Request. Note that this should always be a centralized server, even if the payer/shopper interacts with the merchant system via an app!
Saferpay forwards the merchant request to the Bancontact system, where the IntentUrl and QR-Code data is generated.
The merchant then has multiple options, how to proceed, also depending on the application:
The merchant displays the QR-Code data, so his customer may scan it via the bancontact app.
The IntentUrl is used to perform a direct switch towards the Bancontact payment app
The payer performs the payment. Bancontact authorizes her/his card and sends the necessary data to Saferpay.
Once the payment is finished, two things happen in parallel:
A.1: The payment data is forwarded to the Saferpay system, which saves the data. Once a definitive transaction status has been determined, Saferpay will then call the StateNotificationUrl, which has been defined with the Transaction AlternativePayment Request, to notify the merchant application that the data for this transaction is ready to be pulled.
A.3: The merchant application validates the payment.
B: While the merchant application is notified of the transaction, in the background, the Bancontact app will redirect the payer towards the respective App-RedirectUrl, defined within Transaction AlternativePayment Request, depending on the outcome.
Please refer to this chapter, if you want to test Bancontact.