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.

Request parameters

To create a Divido transaction on the HiPay Enterprise Payment Gateway, you must send these mandatory/complementary parameters in your transaction creation call.

Please note: only the hpayment API is available for this payment method.

The payment page display is managed by HiPay.

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

Request example

{
“currency” : “GBP”,
“payment_product_list” : “divido”,
“orderid” : “123abc0cba321”,
“amount” : “576.51”,
“description” : “Description of the order”,
“country” : “UK”,
“decline_url” : “http://www.mysite.com/decline”,
“exception_url” : “http://www.mysite.com/exception,
“cancel_url” : “http://www.mysite.com/cancel”,
“accept_url” : “http://www.mysite.com/accept”,
“basket” : [
 { 
 "product_reference": "334566", 
 "type": "good",
 "quantity": "1",
"name": "Yellow Jersey Exercise bike E.g. Series", "unit_price": "475.19",
 "tax_rate": "20.00",
 "discount": "0",
 "total_amount": "475.19",
 "product_category": 12
 },
 {"product_reference": "120034",
 "type": "good",
 "quantity": "1",
 "name": "STAMINA Cycling shorts Black L",
 "unit_price": "46.73",
 "tax_rate": "20.00",
 "discount": "0",
 "total_amount": "46.73",
 "product_category": 12 
 },
 {"product_reference": "654321",
 "type": "good",
 "quantity": "1",
 "name": "High-performance cycling gloves Black M",
 "unit_price": "24.6",
 "tax_rate": "20.00",
 "discount": "0",
 "total_amount": "24.6",
 "product_category": 12
 },
 {"product_reference": "SHIPPING-123",
 "name": "UK Express",
"type": "fee",
 "quantity": "1",
 "unit_price": "29.99",
 "discount": "0",
 "tax_rate": "16.67",
 "total_amount": "29.99",
 "product_category": 12
 }
]
“eci” : “7”,
“firstname” : “John”,
“lastname” : “Doe”,
“streetaddress” : “12 Main Street”,
“city” : “Inverurie”,
“zipcode” : “AB51 6BA”,
“country” : “UK”,
“shipto_lastname” : “Champs”,
“shipto_streetaddress” : “12 Mountain Road”,
“shipto_city” : “MANCHESTER”,
“shipto_zipcode” : “M16 0EA”,
“shipto_country” : “UK”,
“birthdate” : “19800701”,
“operation” : “sale”,
“phone” : “07012654321”,
“email” : “john.doe@mail.com”,
“shipto_firstname” : “Hugo”
}

API response

This service returns a forward URL, which displays the available payment facilities (e.g., payment in 6/9/12/36 installments). Once they have made their choice, customers are redirected to Divido’s application form.