Bancontact QR code

Suggest Edits

This feature is currently only available through the payment SOAP API and can only be done as a passthrough, where the 3-D Secure authentication is handled by an external 3DS provider.

You are able to include additional parameters in your API requests that support the QR-Code based authorization with an indicator, if you pay using the Bancontact app or the traditional way, entering the card details.

The following XML document represents an example of an authorization request for payment with Bancontact App:

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns4:IPGApiOrderRequest
xmlns:ns4="http://ipg-online.com/ipgapi/schemas/ipgapi"
xmlns:ns2="http://ipg-online.com/ipgapi/schemas/a1"
xmlns:ns3="http://ipg-online.com/ipgapi/schemas/v1">
    <ns3:Transaction>
        <ns3:CreditCardTxType>
            <ns3:StoreId>230995000</ns3:StoreId>
            <ns3:Type>sale</ns3:Type>
        </ns3:CreditCardTxType>
        <ns3:CreditCardData>
            <ns3:CardNumber>6703*****4449</ns3:CardNumber>
            <ns3:ExpMonth>07</ns3:ExpMonth>
            <ns3:ExpYear>27</ns3:ExpYear>
            <ns3:CardCodeValue>XXX</ns3:CardCodeValue>
        </ns3:CreditCardData>
        <ns3:CreditCard3DSecure>
           <ns3:VerificationResponse>Y</ns3:VerificationResponse>
            <ns3:PayerAuthenticationResponse>Y</ns3:PayerAuthenticationResponse> 
            <ns3:AuthenticationValue>BwABC…neJAAAAAAA=</ns3:AuthenticationValue>
           <ns3:XID>nhrtvl22IdlqdioLX6eQmd3jL6U=</ns3:XID>
        </ns3:CreditCard3DSecure>
        <ns3:Payment>
            <ns3:ChargeTotal>708</ns3:ChargeTotal>
            <ns3:Currency>EUR</ns3:Currency>
        </ns3:Payment>
        <ns3:TransactionDetails>
           <ns3:TransactionOrigin>ECI</ns3:TransactionOrigin>
        </ns3:TransactionDetails>
        <ns3:BancontactQR>
        <ns3:TransactionRoutingMeans>QR Code</ns3:TransactionRoutingMeans> 
        <ns3:IssuerCustomerReference>as23..fsdf</ns3:IssuerCustomerReference>
         </ns3:BancontactQR>
    </ns3:Transaction>
</ns4:IPGApiOrderRequest>

The following represents an example of an authorization request for payment with Bancontact card:

<?xml version="1.0" encoding="UTF-8"?><SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns4:IPGApiOrderRequest
xmlns:ns4="http://ipg-online.com/ipgapi/schemas/ipgapi"
xmlns:ns2="http://ipg-online.com/ipgapi/schemas/a1"
xmlns:ns3="http://ipg-online.com/ipgapi/schemas/v1">
    <ns3:Transaction>
        <ns3:CreditCardTxType>
            <ns3:StoreId>230995000</ns3:StoreId>
            <ns3:Type>sale</ns3:Type>
        </ns3:CreditCardTxType>
        <ns3:CreditCardData>
            <ns3:CardNumber>6703*****4449</ns3:CardNumber>
            <ns3:ExpMonth>07</ns3:ExpMonth>
            <ns3:ExpYear>27</ns3:ExpYear>
            <ns3:CardCodeValue>XXX</ns3:CardCodeValue>
        </ns3:CreditCardData>
        <ns3:CreditCard3DSecure>
           <ns3:VerificationResponse>Y</ns3:VerificationResponse>
            <ns3:PayerAuthenticationResponse>Y</ns3:PayerAuthenticationResponse> 
            <ns3:AuthenticationValue>BwABC…neJAAAAAAA=</ns3:AuthenticationValue>
           <ns3:XID>nhrtvl22IdlqdioLX6eQmd3jL6U=</ns3:XID>
        </ns3:CreditCard3DSecure>
        <ns3:Payment>
           <ns3:ChargeTotal>708</ns3:ChargeTotal>
           <ns3:Currency>EUR</ns3:Currency>
        </ns3:Payment>
        <ns3:TransactionDetails>
           <ns3:TransactionOrigin>ECI</ns3:TransactionOrigin>
        </ns3:TransactionDetails>
        <ns3:BancontactQR>
       <ns3:TransactionRoutingMeans>URL Intent</ns3:TransactionRoutingMeans> 
       <ns3:IssuerCustomerReference>as23..fsdf</ns3:IssuerCustomerReference>
        </ns3:BancontactQR>
    </ns3:Transaction>
</ns4:IPGApiOrderRequest>

An IssuerCustomerReference allows you to also include an identifier for the cardholder.

Updated about 1 month ago

API Products

Point of Sale

Developer

Resources