Passer au contenu
Français - France
Plus de support
Contact
  • Il n'y a aucune suggestion car le champ de recherche est vide.

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, Secondproduct, 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 = maleF = 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 customerThis 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