Integration

We offer this payment methods for the following integration modes. Learn in our dedicated guides about their individual differences:

• Hosted Checkout Page
• Server-to-server
• Mobile and browser SDKs

Find a high level overview in the "Process flows" chapter.

Depending on the integration mode, differences apply:

• Hosted Checkout Page
• Server-to-server
• Mobile and browser SDKs

Hosted Checkout Page

Before you start processing transactions, set up the payment method in your account:

• Log in to the Back Office. Go to Configuration > Payment methods > Bancontact > PM options > BCMC Mobile Application solution activation
• Select the available payment modes your customers can choose from on the Hosted Checkout Page:
  

  Mode	Description
  Display QR code?	Allow your customers to pay by scanning a QR code
  Display URL intent?	Allow your customers to pay with the Payconiq by Bancontact app

• Click on "Save" to confirm your choices
• Depending on your choice, the following modes are available for the respective devices: 

  	Mobile	Tablet	Desktop
  QR code	No	Yes	Yes
  URL intent	Yes	Yes	No
  PAN Bancontact card	Yes	Yes	Yes

Now you are ready to integrate the payment method into your webshop or mobile app.

Add the following properties to a standard CreateHostedCheckout request:

{
   "cardPaymentMethodSpecificInput":{
      "authorizationMode":"SALE",
      "paymentProductId":3012,
      "threeDSecure":{
         
      },
      "transactionChannel":"ECOMMERCE"
   },
   "hostedCheckoutSpecificInput":{
      "locale":"en_EN",
      "returnUrl":"https://yourReturnUrl.com"
   },
   "order":{
      "additionalInput":{
         
      },
      "amountOfMoney":{
         "amount":1000,
         "currencyCode":"EUR"
      },
      "customer":{
         "billingAddress":{
            "countryCode":"BE"
         }
      },
      "references":{
         "merchantReference":"Your reference"
      }
   }
}

Properties	Remarks
order.amountOfMoney amount currencyCode	amount: The gross amount you want to charge for this order currencyCode: The ISO 4217 currency code for this amount
hostedCheckoutSpecificInput          returnURL          locale	returnURL: The URL we redirect your customers to after the payment has been finalised locale: The language version of our Hosted Checkout Page
cardPaymentMethodSpecificInput         paymentProductId	paymentProductId: The numeric identifier of the payment method on our platform. Find this id in the "Overview" chapter. It instructs our platform to send your customers directly to the Bancontact-branded version of our Hosted Checkout Page. If left out, our platform sends your customers to the Hosted Checkout Page instead, allowing them to choose this or any other payment method in your account

Server-to-server

Add the following properties to a standard CreatePayment request:

{
   "cardPaymentMethodSpecificInput":{
      "card":{
         "cardholderName":"BCMC Buyer",
         "cardNumber":"0000000000000000",
         "expiryDate":"0130"
      },
      "threeDSecure":{
         "redirectionData":{
            "returnUrl":"https://secure.ogone.com/ncol/test/displayparams.asp"
         }
      },
      "authorizationMode":"SALE",
      "recurring":{
         
      },
      "transactionChannel":"ECOMMERCE",
      "paymentProductId":3012
   },
   "fraudFields":{
      "customerIpAddress":"40.91.241.131"
   },
   "order":{
      "additionalInput":{
         
      },
      "amountOfMoney":{
         "amount":1000,
         "currencyCode":"EUR"
      },
      "customer":{
         "billingAddress":{
            "countryCode":"BE"
         }
      },
      "references":{
         "merchantReference":"BDD_20230118060724344_UNNERD0101E1_SS_00"
      }
   }
}

Properties	Remarks
order.amountOfMoney amount currencyCode	amount: The gross amount you want to charge for this order currencyCode: The ISO 4217 currency code for this amount
cardPaymentMethodSpecificInput         card              cardNumber              expiryDate              cardholderName         returnURL         paymentProductId	card: The credentials of the card used for the payment Make sure to fulfill the necessary PCI DSS requirements for sending sensitive data returnURL: The URL we redirect your customers to after the payment has been finalised paymentProductId: The numeric identifier of the payment method on our platform. Find this id in the "Overview" chapter

Mobile/Client Integration

As this payment method is available only via Hosted Checkout Page for mobile payments, your app needs to implement the respective flow/request.

Check out the "Process flows" chapter / Hosted Checkout Page chapter to learn more.