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"
    }
}