AID in HPP Flow
The AID object invokes the initialize-payment method to initiate a new payment transaction using Velocity HPP. It provides AID data when a request is initialized. It also returns the required transaction information and merchant configuration for the payment to be successfully processed.
Note: For details about
initialize-paymentand payment flow, refer to the API Reference section.
Order Info Object Request to Invoke HPP
To create AID data for HPP, create an Order Info object and send it in the Initialize Payment request as shown in the following sample:
{
"order":{
"shipping":{
"name":"Person Name",
"street":"Address line1",
"street2":"Address line2",
"city":"City",
"state":"state",
"zip":"postal code",
"country":"country of person"
},
"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":"5577868383"
}
},
"additional_data":{
"param":[
{
"name":"loyality_id",
"text":"value"
},
{
"name":"passenger_tier",
"text":"value"
},
{
"name":"passport_no",
"text":"value"
}
]
}
},
{
"seq":"2",
"title":"Mr",
"first_name":"Passanger2",
"last_name":"last2",
"type":"CHD",
"contact_info":{
"email":"[email protected]",
"mobile":{
"country_id":"640",
"text":"5577868383"
}
},
"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":"4C"
},
{
"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":"2020-05-15T23:25:00",
"arrival_time":"2020-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":"2020-05-20T16:40:00",
"arrival_time":"2020-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"
}
]
}
}
]
}
}
}
Order Parameters
The Order parameters contain details of a travel itinerary and include Shipping and Line-item parameters.
| Parameter | Required | Description |
|---|---|---|
| shipping | No | Shipping address. Refer to 'Shipping Parameters,' below, for more information. |
| line_items | Yes | The detailed information of the travel itinerary, which includes an array of line_item. Refer to 'Line-item Parameters,' below, for more information. |
Shipping Parameters
The Shipping parameters are listed in the table below.
| Parameters | Required | Description |
|---|---|---|
| name | Yes | The name of a customer. |
| street | Yes | The first line of address. |
| street2 | No | The second line of address. |
| city | Yes | The city name. |
| state | Yes | The state name. |
| zip | Yes | The zip code. |
| country | Yes | The country name. |
Line-item Parameters
The Line-item parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| product | Yes | The detailed information of travel itinerary, which includes: • Fare information • Traveller information • Trip Information Refer to 'Product Parameters,' below, for details. |
| amount | Yes | The total amount for an order. |
| points | No | The loyalty points used for this order by a customer. |
| reward | No | The reward points used for this order by a customer. |
| quantity | No | The quantity of this line item. Default value is 1. |
| additional_data | No | Insert additional information here. For example, its key value data structure which accepts values for parameters as deviceFingerPrint, info_cust_url, office_id, flexi_search, lowest_fare. |
Product Parameters
The product parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| sku | Yes | The short code for travel itinerary. For example, PNR and order number. |
| name | Yes | The name of a journey. For example, ONEWAY, RETURN, MULTICITY, MYB, and OLCI. |
| description | No | The description of travel itinerary. |
| image_url | No | The image URL of the product. |
| airline_data | No | The low-level information of travel itinerary, which includes: • Fare information • Traveller information • Trip information Refer to 'Airline_data Parameters,' below, for details. |
Airline_data Parameters
The airline_data parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| profiles | Yes | An array of profile object, which provides traveler information for the travel itinerary. Refer to 'Profile Parameters,' below, for details. |
| billing_summary | Yes | An array of billing summary, which provides billing details of a journey. Refer to 'Billing Summary Parameters,' below, for details. |
| trips | Yes | An array of the trip object, which provides trip information for the travel itinerary. Refer to 'Trip Parameters,' below, for details. |
Profile Parameters
The profile parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| seq | Yes | The sequence number of a passenger. |
| title | Yes | The title of a passenger. For example, Mr., Mrs., and Ms. |
| first_name | Yes | The first name of a passenger |
| last_name | Yes | The last name of a passenger. |
| type | Yes | The type of a passenger. For example, adult, child, and infant. Refer to Passenger Types in Reference for details. |
| contact_info | Yes | An object containing the following contact information of a passenger: email, mobile. Refer to 'Contact Info Parameters,' below, for details. |
| additional_data | No | The additional passenger information related to a passenger profile such as loyalty number, passenger tier, and passport number. |
Billing Summary Parameters
The billing_summary parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| fare_detail | Yes | An array of fare details of a journey. |
| add_ons | Yes | The additional information of a journey. Refer to 'Add-on Parameters,' below, for details. |
Trip Parameters
The trip parameters are listed below.
| Parameter | Required | Description |
|---|---|---|
| tag | Yes | The sequence of this journey in journeys. |
| seq | Yes | The sequence of this trip or layover within a journey from end to end. |
| origin | Yes | An object of that provides origin location information for the travel itinerary. Refer to 'Origin Parameters,' below, for details. |
| destination | Yes | An object that provides destination location information for the travel itinerary. Refer to 'Destination Parameters,' below, for details. |
| departure_time | Yes | The departure time of flight from origin in GMT. |
| arrival_time | Yes | The arrival time of flight on destination in GMT. |
| booking_class | Yes | The booking class (RBD – first letter of fare-basis). For example, H. |
| service_level | Yes | The cabin class opted. For example, XL, X, M, and S. |
| transportation | Yes | An array that provides transportation information for the travel itinerary. Refer to 'Transportation Parameters,' below, for details. |
| additional_data | No | Additional trip details. For example, fare_basis and non-stop. |
The tables below describe the sub-parameters used in a Velocity HPP AID object. This includes Contact Info, Fare Details, Add-on, Origin, Destination, Transportation, Mobile and Carrier parameters.
Contact Info Parameters
The contact_info parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| Yes | The email id of a passenger. | |
| mobile | Yes | The mobile number of a passenger along with country ID. It contains the sub-parameters country_id and mobile. Refer to 'Mobile Parameters,' below, for details. |
Fare Details Parameters
The fare parameters (in fare_detail) are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| type | Yes | The type of a passenger. For example, adult, child, and infant. Refer to Passenger Types in Reference for details. |
| description | Yes | The description of the fare. |
| currency | Yes | The alpha3 ISO currency code of the fare amount. |
| product_code | Yes | The product code of item. |
| product_category | Yes | The product category code. |
| product_item | Yes | The product name. |
| amount | Yes | The amount charged for the product. This can be a decimal value. |
Add-on Parameters
The add_ons parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| profile_seq | No | The sequence number of a passenger linked to this add-on. Note: This parameter is mandatory only if it is associated with a passenger. |
| trip_tag | No | The tag number associated with a trip, which helps identify a trip. Note: This parameter is mandatory only if an add-on is associated with a trip. |
| trip_seq | No | The trip sequence number to identify the leg of the trip. Note: This parameter is mandatory if add-on is associated with the leg a of trip. |
| description | Yes | The description of the add-on parameters. |
| currency | Yes | The alpha3 ISO currency code of the fare amount. |
| product_code | Yes | The code number to identify the add-on product. |
| product_category | Yes | The code number to identify the add-on product category. |
| product_item | Yes | The code number to identify the add-on product item. |
| amount | Yes | The amount paid for the add-on product. This can be a decimal value. |
Origin Parameters
The origin parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| external_id | Yes | The IATA code of an airport. |
| country_id | Yes | The ISO numeric country code. |
| time_zone | Yes | The time zone of the place where a journey originates. The time zone is offset; for example,+08:00.Note: You must send time_zone in +/-HH:MM format. |
| text | Yes | The name of airport and terminal. |
Destination Parameters
The destination parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| external_id | Yes | The IATA code of airport. |
| country_id | Yes | The ISO numeric country code. |
| time_zone | Yes | The time zone of the destination. The time zone is offset; for example, +08:00.Note: You must send time_zone in +/-HH:MM format. |
| text | Yes | The name of airport and terminal. |
Transportation Parameters
The transportation parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| code | Yes | The marketing airline code for transportation. For example, 5J, PR, OD, and AV. |
| number | Yes | The operating flight number. |
| carriers | Yes | The array of a carrier used in this journey. Refer to 'Carrier Parameters,' below, for details. |
Mobile Parameters
The mobile parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| country_id | Yes | Three-digit numeric ISO country code of the mobile number country. See Country in Reference. |
| text | Yes | The mobile number of a passenger. |
Carrier Parameters
The carrier parameters are listed in the table below.
| Parameter | Required | Description |
|---|---|---|
| type | Yes | Aircraft type information. For example, Aircraft Boeing-737-9. |
| code | Yes | The code for operating airline. For example, PROD, and AV. |
| number | Yes | The flight number of an airline. |
Updated 4 months ago