HPP
Reference
This page and its subpages provide reference information for CellPoint Digital Velocity's Hosted Payment Page (HPP) integration. For information on how to integrate this payment solution, see our Hosted Payment Page (HPP) integration guide.
Request
Below is request syntax to invoke Velocity HPP as a request. For descriptions of parameters, see the Request Parameters subpage.
Sample Request
<!DOCTYPE HTML>
<html>
<body>
<form action="https://{HPP_HOST}/views/web.php" method="POST" id="order-form">
<input type="hidden" name="country" value="200"/>
<input type="hidden" name="clientid" value="10022"/>
<input type="hidden" name="account" value="100220"/>
<input type="hidden" name="accept-url" value="{accept-url}"/>
<input type="hidden" name="cancel-url" value="{cancel-url}"/>
<input type="hidden" name="callback-url" value="{callback-url}"/>
<input type="hidden" name="orderid" value="1561120588855"/>
<input type="hidden" name="operator" value="20000"/>
<input type="hidden" name="language" value="us"/>
<input type="hidden" name="customer-ref" value="test"/>
<input type="hidden" name="email" value="[email protected]"/>
<input type="hidden" name="mobile-country" value="200"/>
<input type="hidden" name="mobile" value="9898989898"/>
<input type="hidden" name="amount" value="1.232"/>
<input type="hidden" name="auth-token" value="E814B1DE-2A6A-4A09-B522-13D5CD9829D1"/>
<input type="hidden" name="init-token" value="f26ebd24d623f228cb8bc37f30939003ffd1c98b2d24ab8be35e9a881521fc1b4b3f82bf131471ff68a9c716c20af08141ff4a1337f0c31ee8ddc75bedb35fd8"/>
<input type="hidden" name="nonce" value="12345"/>
<input type="hidden" name="orderdata" value="{JSON order-data}"/>
<input type="hidden" name="gtm-data" value="{gtmData}"/>
<input type="hidden" name="profile-id" value="XC2G6BYDBqibRdO06G1OGZq6OBxM"/>
<input type="hidden" name="response-content-type" value=" 2"/>
<input type="hidden" name="txntype" value="1|3|5"/>
<input type="hidden" name="additionaldata" value='{
"additional_data": {
"param": [
{
"name": "session_token",
"text": "2A6A4A09B52213D5CD9829D1"
},
{
"name": "hold_fee_amount",
"text": "150"
},
{
"name": "hold_fee_currency_code",
"text": "608"
},
{
"name": "hold_period",
"text": "8"
},
{
"name": "stepper",
"text": "1"
}
]
}
}'/>
<input type="submit" value="Pay" class="btn-link"/>
</form>
</body>
</html>
Sample Request with Display Order Data and Airline Itinerary Data (AID)
An HPP request can include the orderdata
parameter with a JSON object in value
. The object may include airline_data
with Airline Itinerary Data (AID).
Below is an example of the JSON found in orderdata
. For parameter descriptions, see the Request Parameters subpage.
{
"order":{
"shipping":{
"name":"First Last",
"street":"Address line1",
"street2":"Address line2",
"city":"City",
"state":"State",
"zip":"99999",
"country":"103"
},
"line_items":{
"line_item":[
{
"product":{
"sku":"product-ticket",
"name":"RETURN",
"description":"DXB-BKK:BKK-DXB",
"airline_data":{
"profiles":{
"profile":[
{
"seq":"1",
"title":"Mr",
"first_name":"firstname1",
"last_name":"lastname1",
"type":"ADT",
"contact_info":{
"email":"[email protected]",
"mobile":{
"country_id":"640",
"text":"5573338383"
}
},
"additional_data":{
"param":[
{
"name":"loyality_id",
"text":"value"
},
{
"name":"passenger_tier",
"text":"value"
},
{
"name":"passport_no",
"text":"value"
}
]
}
},
{
"seq":"2",
"title":"Mr",
"first_name":"firstname2",
"last_name":"lastname1",
"type":"CHD",
"contact_info":{
"email":"[email protected]",
"mobile":{
"country_id":"640",
"text":"5573338383"
}
},
"additional_data":{
"param":[
{
"name":"passport_no",
"text":"value"
}
]
}
}
]
},
"billing_summary":{
"fare_detail":{
"fare":[
{
"description": "Localization Key - ADULTBASEFARE",
"currency":"PHP",
"amount":"110",
"type":"ADT",
"product_code":"BASE",
"product_category":"FARE",
"product_item":"Base Fare"
},
{
"description":"Localization Key - ADULTBASEFARE Surcharge",
"currency":"PHP",
"amount":"10",
"type":"ADT",
"product_code":"BASE",
"product_category":"FARE",
"product_item":"Internation/Domestic Surcharge"
},
{
"description":"Localization Key - Sales Tax Colombia",
"currency":"PHP",
"amount":"20",
"type":"ADT",
"product_code":"YSTR",
"product_category":"TAX",
"product_item":"Sales Tax Colombia"
},
{
"description":"Localization Key - International Airport Facility Charge Colombia",
"currency":"PHP",
"amount":"20",
"type":"ADT",
"product_code":"COAE",
"product_category":"TAX",
"product_item":"International Airport Facility Charge Colombia"
},
{
"description":"Localization Key - CHILDBASEFARE",
"currency":"PHP",
"amount":"70.89",
"type":"CHD",
"product_code":"BASE",
"product_category":"FARE",
"product_item":"Base Fare"
},
{
"description":"Localization Key - CHILDTAX",
"currency":"PHP",
"amount":"10",
"type":"CHD",
"product_code":"",
"product_category":"TAX",
"product_item":"Tax Child"
}
]
},
"add_ons":{
"add_on":[
{
"description":"Localization Key - SEAT PRICE",
"currency":"PHP",
"amount":"110",
"profile_seq":"1",
"trip_tag":"1",
"trip_seq":"1",
"product_code":"SEAT",
"product_category":"Service",
"product_item":"4C"
},
{
"description":"Localization Key - SEAT TAX",
"currency":"PHP",
"amount":"10",
"profile_seq":"2",
"trip_tag":"1",
"trip_seq":"1",
"product_code":"SEAT",
"product_category":"Service",
"product_item":"4B"
},
{
"description":"Localization Key - MEAL Price",
"currency":"PHP",
"amount":"110",
"profile_seq":"1",
"trip_tag":"1",
"trip_seq":"1",
"product_code":"MEAL",
"product_category":"Service",
"product_item":"VEG MEAL"
},
{
"description":"Localization Key - MEAL Price",
"currency":"PHP",
"amount":"110",
"profile_seq":"2",
"trip_tag":"1",
"trip_seq":"1",
"product_code":"MEAL",
"product_category":"Service",
"product_item":"Sandwich"
},
{
"description":"Localization Key - Bicycle",
"currency":"PHP",
"amount":"110",
"profile_seq":"1",
"trip_tag":"1",
"trip_seq":"1",
"product_code":"MISC",
"product_category":"Special Service",
"product_item":"Bicycle"
},
{
"description":"Localization Key - GOLF Eqp",
"currency":"PHP",
"amount":"110",
"profile_seq":"1",
"trip_tag":"1",
"trip_seq":"1",
"product_code":"MISC",
"product_category":"Special Service",
"product_item":"Golf Eqp."
},
{
"description":"Localization Key - Wheel Chair",
"currency":"PHP",
"amount":"0",
"profile_seq":"1",
"trip_tag":"0",
"trip_seq":"0",
"product_code":"WCHR",
"product_category":"Special Service",
"product_item":"Wheel Chair"
},
{
"description":"Localization Key - Travel Assitance",
"currency":"PHP",
"amount":"40",
"profile_seq":"1",
"trip_tag":"1",
"trip_seq":"1",
"product_code":"INS1",
"product_category":"INSURANCE",
"product_item":"INS30DAY"
}
]
}
},
"trips":{
"trip":[
{
"tag":"1",
"seq":"1",
"origin":{
"country_id":"608",
"external_id":"DXB",
"text":"Dubai International Airport - Terminal 2",
"time_zone":"+08:00"
},
"destination":{
"country_id":"648",
"external_id":"BKK",
"text":"Bangkok International Airport - Terminal 3",
"time_zone":"+08:00"
},
"departure_time":"2026-05-15T23:25:00",
"arrival_time":"2026-05-16T13:05:00",
"booking_class":"E",
"service_level":"XL",
"transportation":{
"code":"AV",
"number":"123",
"carriers":{
"carrier":[
{
"type":"Aircraft Boeing-737-9",
"code":"AV",
"number":"123"
}
]
}
},
"additional_data":{
"param":[
{
"name":"NONSTOP",
"text":"Yes"
},
{
"name":"fare_basis",
"text":"EGHN&b46"
}
]
}
},
{
"tag":"2",
"seq":"1",
"origin":{
"country_id":"648",
"external_id":"BKK",
"text":"Bangkok International Airport - Terminal 3",
"time_zone":"+08:00"
},
"destination":{
"country_id":"608",
"external_id":"DXB",
"text":"Dubai International Airport - Terminal 2",
"time_zone":"+08:00"
},
"departure_time":"2026-05-20T16:40:00",
"arrival_time":"2026-05-20T21:40:00",
"booking_class":"E",
"service_level":"XL",
"transportation":{
"code":"AV",
"number":"123",
"carriers":{
"carrier":[
{
"type":"Aircraft Boeing-737-9",
"code":"AV",
"number":"123"
}
]
}
},
"additional_data":{
"param":[
{
"name":"fare_basis",
"text":"EGHN&b46"
}
]
}
}
]
}
}
},
"amount":"10022",
"additional_data":{
"param":[
{
"name":"flight_sel_url",
"text":"URL"
},
{
"name":"info_cust_url",
"text":"URL"
},
{
"name":"office_id",
"text":"DEAVSLK"
},
{
"name":"promo_code",
"text":"DEAV323"
},
{
"name":"flexi_search",
"text":"Yes"
},
{
"name":"lowest_fare",
"text":"Yes"
}
]
}
}
]
}
}
}
Response
Below is an example of the form data element returned when the customer is redirected to the merchant's accept or reject URL. For descriptions of parameters, see the Response Parameters subpage.
{
"client_id": "12752",
"account_id": "127520",
"session_id": "1999302",
"sale_amount": {
"value": "60000",
"currency_id": "840",
"decimals": "2",
"alpha3code": "USD"
},
"status": {
"code": "4030",
"message": "Session Complete"
},
"transactions": {
"transaction": [
{
"id": "80806384",
"order_id": "GFHJB352",
"fee": "0",
"hmac": "5afaa6a66f24f5059b4d22a2617d0237f97fe06e00e9e9b4d9b43c4e7b77bb7ccacb682105d5468c57e62f8191f88815e8d9dd234d1b346741ffc63961bdac3e",
"product_type": "100",
"approval_code": "111835",
"payment_method": "CD",
"payment_type": "1",
"date_time": "2025-05-22T16:04:01 00:00",
"amount": {
"value": "60000",
"currency_id": "840",
"decimals": "2",
"alpha3code": "USD",
"conversion_rate": "1"
},
"sale_amount": {
"value": "60000",
"currency_id": "840",
"decimals": "2",
"alpha3code": "USD"
},
"status": {
"code": "2001",
"message": "Payment captured by PSP"
},
"psp": {
"id": "82",
"name": "Nuvei",
"external_id": "8110000000008541824"
},
"card": {
"id": "8",
"card_name": "VISA",
"masked_card_number": "*************",
"expiry": "**/**"
},
"customer_info": {
"language": "en",
"email": "*******",
"mobile": "*******",
"device_id": "*******"
},
"billing_address": {
"first_name": "*****",
"last_name": "*****",
"street": "*****",
"street2": "*****",
"city": "*****",
"state": "*****",
"postal_code": "*****",
"country": "*****",
"mobile": "*****",
"email": "*****",
"billing_idc": "*****",
"alpha2code": "*****"
},
"pos": "200",
"ip_address": "84.79.201.0",
"fraud_status_code": "3011",
"fraud_status_desc": "Pre Auth Success",
"route_config_id": "2266",
"fraud": {
"status_code": "3011",
"status_desc": "Pre Auth Success",
"pre_auth_ext_id": "7479299554316097104605",
"pre_auth_ext_status_code": "100",
"pre_auth_provider_id": "64",
"pre_auth_fraud_status": "3011"
},
"installment": "0",
"accept_url": "https://cpd-demo.cellpoint.app/confirmation?s=1",
"cancel_url": "https://cpd-demo.cellpoint.app/confirmation?s=0",
"txn_type_id": "1",
"performed_operations": {
"performed_operations": [
{
"amount": "60000",
"created": "2025-05-22T16:04:01 00:00",
"performedOperations": "1001",
"modified": "2025-05-22T16:04:01 00:00",
"status": "done"
},
{
"amount": "60000",
"created": "2025-05-22T16:05:56 00:00",
"performedOperations": "2000",
"modified": "2025-05-22T16:05:58 00:00",
"status": "done"
},
{
"amount": "60000",
"created": "2025-05-22T16:05:58 00:00",
"performedOperations": "2001",
"modified": "2025-05-22T16:05:58 00:00",
"status": "done"
}
]
},
"performed_operation_time": "2025-05-22T16:05:58 00:00"
}
]
},
"callback_url": "https://ehpp2.cellpoint.app/views/redirect_response.php",
"session_type": "1",
"order_status": {
"code": "1"
}
}
Updated 1 day ago