Skip to main content
Français Italiano Português

HiPay Enterprise – Bancontact QR code

 BC_logo_ORGNL_RGB.png

If you want to display the QR code directly on your website, you are in the right place.

 

 

You can display the QR code in an iFrame (HTTPS only): 

mceclip0.png

Service endpoints

There are two endpoints (base URLs) to which you can make your API calls:

  • Stage, if you are testing your integration,
  • and Production, when you have finished testing and want your application to go live.
Environment Endpoint

Stage

 https://stage-secure-gateway.hipay-tpp.com/rest/v1/order

Production

 https://secure-gateway.hipay-tpp.com/rest/v1/order

 

Request parameters

(For further details, please refer to the technical documentation.)

Format abbreviation Description
AN Alphanumeric characters (a-z, A-Z, 0-9)
A Alphabetic characters only (a-z, A-Z)
N Numeric characters only
R Decimal number with explicit decimal point, signed
JSON JavaScript Object Notation

 

 Field name  Format  Length  Description
 orderid AN 32 ID of the order
 operation A - Set the value:
Sale = debits the customer immediately
 eci N [string] 1 Set the value:
7 
 description AN 128 Short description of the order
 long_description AN -  Additional description of the order
 payment_product AN 255 bancontactqrcode
 currency A 3 Base currency for the order (default to EUR)
This three-character currency code complies with ISO 4217.
 amount R - Order total amount
 shipping R - Shipping fees for the order (default to zero)
Can be omitted if the shipping fees value is zero.
 tax R - Tax amount for the order (default to zero)
Can be omitted if the tax amount value is zero.
 tax_rate R - Tax rate for the order
  custom_data JSON - You can use this parameter to submit custom values you wish to show in HiPay’s back office transaction details, to receive back in the API response messages and in the notifications or to activate specific anti-fraud rules.

E.g.:
custom_data => {
"shipping_method":"click and collect",
"first_order":"0",
"products_list":"First product, Second
product, Third product"}
Field name Format Length Description
email AN - Customer’s email address
phone AN
 - Customer’s phone number
birthdate N 8 Customer’s birthdate (YYYYMMDD)
For fraud detection purposes
gender A 1

Gender of the customer:

M = male
F = female
firstname AN
 - Customer’s first name
lastname AN - Customer’s last name
streetaddress AN - Customer’s street address
streetaddress2 AN -

Additional address information of the customer

(e.g.: building, floor, flat, etc.)
city AN - Customer’s city
state AN - State of the country
zipcode AN - Zip or postal code of the customer
country A 2 Country code of the customer
This two-letter country code complies with ISO 3166-1 (alpha 2).
shipto_firstname AN - First name of the order’s recipient
shipto_lastname AN - Last name of the order’s recipient
shipto_streetaddress AN - Street address where the order is to be shipped
shipto_streetaddress2 AN - Additional information about the street address where the order is to be shipped (e.g.: building, floor, flat, etc.)
shipto_city AN - City where the order is to be shipped
shipto_state AN - State where the order is to be shipped
shipto_zipcode AN - Zip or postal code where the order is to be shipped
shipto_country A 2

Country code where the order is to be shipped

This two-letter country code complies with ISO 3166-1 (alpha 2).
ipaddr AN - Customer’s IP address
cid AN - Unique customer ID
accept_url AN - URL to redirect your customers to once the payment process is completed successfully
decline_url AN - URL to redirect your customers to after the acquirer has declined the payment
pending_url AN - URL to redirect your customers to when the payment request has been submitted to the acquirer, but the response is not available yet
exception_url AN - URL to redirect your customers to after a system failure
cancel_url AN - URL to redirect your customers to when they decide to abort the payment

 

Full PHP example:


$data= array(
  "orderid"=> 'HP'.rand(microtime(0),100000),
  "operation"=> "sale",
  "eci"=> "7",
  "description"=> "Description of the order",
  "long_description"=> "Long description of the order",
  "payment_product"=> "bancontactqrcode",
  "email"=> "test@hipay.com",
  "currency"=> "EUR",
  "amount"=> "100",
  "shipping"=> 10,
  "tax"=> 10,
  "tax_rate"=> 10,
  "custom_data"=>
  '{
    "shipping_method":"click and collect",
    "first_order":"0",
    "products_list": "First product, Second product",
    "_reporting_data_1":"my custom data 1",
    "_reporting_data_2":"my custom data 2",
    "_reporting_data_3":"my custom data 3",
    "_reporting_data_4":"my custom data 4",
    "_reporting_data_5":"my custom data 5"
	}',

  // Customer information
  "email"=> "jane.doe@test.com",
  "phone"=> "0612345678",
  "birthdate"=> 19890525,
  "gender"=> "f",
  "firstname"=> "Jane",
  "lastname"=> "Doe",
  "streetaddress"=> "10 rue de la facturation",
  "streetaddress2"=> "Bâtiment A",
  "city"=> "Paris",
  "zipcode"=> "75012",
  "country"=> "FR",
  "shipto_firstname"=> "Jane",
  "shipto_lastname"=> "Doe",
  "shipto_streetaddress"=> "20 rue de la livraison",
  "shipto_streetaddress2"=> "Appt n°5",
  "shipto_city"=> "Paris",
  "shipto_zipcode"=> "75001",
  "shipto_country"=> "FR",
  "ipaddr"=> "193.248.51.27",
  "cid"=> "123",
  "accept_url"=> "https://example.com/accept",
  "decline_url"=> "https://example.com/decline",
  "pending_url"=> "https://example.com/pending",
  "exception_url"=> "https://example.com/exception",
  "cancel_url"=> "https://example.com/cancel"
	);

 

The response API is useful to redirect the customer to the Bancontact Mobile payment page.

JSON API response example:


{
	"state":"forwarding",
  "reason":"",
  "forwardUrl":"https:\/\/stage-secure-gateway.hipay-tpp.com\/gateway\/forward\/32215212016aafc0dc42c61aa9145256",
  "test":"true","mid":"00001234567","attemptId":"1","authorizationCode":"",
  "transactionReference":"800004182295",
  "referenceToPay":
  {
  	"urlbutton":"BEPGenApp:\/\/DoTx?TransId=1PROD-TXM-PSP.BCMC.AW.ATOS.NET\/BEP$GVBDGNJWIRBEEOCGIIYDORKD"
  },
  "dateCreated":"2019-09-13T11:00:53+0000",
  "dateUpdated":"2019-09-13T13:00:54+0200",
  "dateAuthorized":"",
  "status":"140","message":"Authentication requested",
  "authorizedAmount":"0.00","capturedAmount":"0.00",
  "refundedAmount":"0.00",
  "creditedAmount":"0.00",
  "decimals":"2",
  "currency":"EUR",
  "ipAddress":"193.248.51.27",
  "ipCountry":"FR",
  "deviceId":""
  ,"avsResult":"",
  "cvcResult":"",
  "eci":"7",
  "paymentProduct":"bancontactqrcode",
  "paymentMethod":"",
  "threeDSecure":"",
  "fraudScreening":
  {
  	"scoring":"0",
    "result":"ACCEPTED",
    "review":""
   },
   "order":
   {
   	"id":"HP54730",
    "dateCreated":"2019-09-13T11:00:53+0000",
    "attempts":"1",
    "amount":"100.00",
    "shipping":"10.00",
    "tax":"10.00",
    "decimals":"2",
    "currency":"EUR",
    "customerId":"123",
    "language":"en_US",
    "email":"jane.doe@test.com"
   },
  }

 

To consider an accepted payment, it is appropriate to rely on the server-to-server notification containing the following values:
status=118
message=Captured

You can receive the server-to-server notification in:
- POST "application/x-www-form-urlencoded" format
- POST XML

POST accepted payment confirmation server-to-server notification example:


state=completed
&test=true
&mid=00001234567
&attempt_id=1
&authorization_code=TEST
&transaction_reference=800004182295
&date_created=2019-09-13T11%3A00%3A53%2B0000
&date_updated=2019-09-13T11%3A04%3A10%2B0000
&date_authorized=2019-09-13T11%3A05%3A10%2B0000
&status=118
&message=Captured
&authorized_amount=100.00
&captured_amount=100.00
&refunded_amount=0.00
&decimals=2
&currency=EUR
&ip_address=193.248.51.27
&ip_country=FR
&device_id=
&custom_data%5Bfirst_order%5D=0
&custom_data%5Bproducts_list%5D=First+product%2C+Second+product
&custom_data%5B_reporting_data_1%5D=my+custom+data+1
&custom_data%5B_reporting_data_2%5D=my+custom+data+2
&custom_data%5B_reporting_data_3%5D=my+custom+data+3
&custom_data%5B_reporting_data_4%5D=my+custom+data+4
&custom_data%5B_reporting_data_5%5D=my+custom+data+5
&custom_data%5Bshipping_method%5D=click+and+collect
&avs_result=
&cvc_result=
&eci=7
&payment_product=bancontactqrcode
&fraud_screening%5Bscoring%5D=0
&fraud_screening%5Bresult%5D=accepted
&fraud_screening%5Breview%5D=
&order%5Bid%5D=HP54730
&order%5Bdate_created%5D=2019-09-13T11%3A00%3A53%2B0000
&order%5Battempts%5D=1
&order%5Bamount%5D=100.00
&order%5Bshipping%5D=10.00
&order%5Btax%5D=10.00
&order%5Bdecimals%5D=2
&order%5Bcurrency%5D=EUR
&order%5Bcustomer_id%5D=123
&order%5Blanguage%5D=en_US
&order%5Bemail%5D=jane.doe%40test.com
&payment_reference%5BurlButton%5D=BEPGenApp%3A%2F%2FDoTx%3FTransId%3D1PROD-TXM-PSP.BCMC.AW.ATOS.NET%2FBEP%24GVBDGNJWIRBEEOCGIIYDORKD

Related articles