DerbySoft GDN Seller API

TABLE OF CONTENTS

Request Payload Example

Request Payload Structure
Response - OrderViewRS

This endpoint enables sellers to pay and issue an order for the selected flight offers and optional ancillary products-such as seat selection, extra baggage, priority boarding, etc. Alternatively, it can create a hold booking without immediate payment.

Version	Date	Description of Edit
Beta	2025/09/16	Initial Commit
v1.0	2025/10/22	OrderView: Add gdnOrderId/gdnBookingId Modified Price object Add technicalCapabilities object Add payment object Add modificationHistory
v1.1	2025/11/23	OrderCreate: Add bundleOrders node under orderCreate to support bundle feature OrderView: Add includedInBundle field under serviceOrder node. Add bundleOrder node to display comprehensive bundle information
v1.2	2026/04/23	OrderCreate: Add GST related field in contactInfos node. OrderView: Return GST related field in contactInfos node.
V1.3	2026/07/02	Added servicePsgFares under orderView.serviceInfos to return ancillary passenger fare details. Added totalWeightMeasur under baggage weight Allowance in OrderView and service order baggage data.
V2.0	2026/08/15	OrderCreate: Added Secondary Contact & EmergencyContact contact type add new Carbon Offset service type special pax doc types (OFW, PWD, SCP) order settlement currency Multi-FOP methods (WALLET, BSP_CASH, CARD, etc.). OrderViewRS: Added promotionDetailInfo under flight offer totalPrice and passenger fare price. Extended full order response with physical legInfos[] (stopovers) Carbon_emissions Secondary ContactInfo &emergencyContactInfo bundle FreeServices[] (with ssrCode) Multi-FOP payment status itemized taxCode.

Request Details
Path	v1.0	/api/flight/connectivity/order/orderCreate
Path	v1.1	/api/flight/connectivity/order/V1.1/orderCreate
Path	v1.2	/api/flight/connectivity/order/V1.2/orderCreate
Path	v1.3	/api/flight/connectivity/order/V1.3/orderCreate
Path	v2.0	/api/flight/connectivity/order/V2.0/orderCreate

Request Payload Example

{
   "createOrder": {
       "tripsInfo": {
           "onwardTrip": {
               "segmentInfos": [
                   {
                       "duration": 130,
                       "flightDesignator": {
                           "marketingCarrier": {
                               "marketingFlightNumber": "311",
                               "marketingCarrierName": "FD",
                               "equipmentType": "320A",
                               "marketingCarrierCode": "FD"
                           }
                       },
                       "segmentSequence": 1,
                       "legInfos": [
                           {
                               "duration": 130,
                               "departureAirport": "DMK",
                               "legSequence": 1,
                               "arrivalAirport": "KUL",
                               "equipmentType": "320A",
                               "properties": [
                                   {
                                       "unit": "kg",
                                       "value": "89",
                                       "key": "carbon_emission"
                                   }
                               ]
                           }
                       ],
                       "arrivalInfo": {
                           "airportName": "Kuala Lumpur International Airport",
                           "arrivalTime": "10:15",
                           "airportCode": "KUL",
                           "arrivalDate": "2026-10-24"
                       },
                       "departureInfo": {
                           "departureTime": "07:05",
                           "airportName": "Don Mueang International Airport",
                           "airportCode": "DMK",
                           "departureDate": "2026-10-24"
                       }
                   },
                   {
                       "duration": 75,
                       "flightDesignator": {
                           "marketingCarrier": {
                               "marketingFlightNumber": "711",
                               "marketingCarrierName": "AK",
                               "equipmentType": "320A",
                               "marketingCarrierCode": "AK"
                           }
                       },
                       "segmentSequence": 2,
                       "legInfos": [
                           {
                               "duration": 75,
                               "departureAirport": "KUL",
                               "legSequence": 1,
                               "arrivalAirport": "SIN",
                               "equipmentType": "320A",
                               "properties": [
                                   {
                                       "unit": "kg",
                                       "value": "51",
                                       "key": "carbon_emission"
                                   }
                               ]
                           }
                       ],
                       "arrivalInfo": {
                           "airportName": "Changi Airport",
                           "arrivalTime": "13:00",
                           "airportCode": "SIN",
                           "terminal": "4",
                           "arrivalDate": "2026-10-24"
                       },
                       "departureInfo": {
                           "departureTime": "11:45",
                           "airportName": "Kuala Lumpur International Airport",
                           "airportCode": "KUL",
                           "terminal": "2",
                           "departureDate": "2026-10-24"
                       }
                   }
               ],
               "flightType": 2
           },
           "tripKey": "TBdlisxuDmfz9NmyDmzBtlayb/e99DIA6PvDL0ySud39nHfdwrZFgBU1iv3AQNtbt/JvKA6OU2Vr+3uu2d9TXzDuKWlF9buoHpSYZ0iHiyvHUqv8uEViYkid5C3bKNq38+coF9JTfT0o/b2fEGOdSLRyGHrHujDCi4aSjdo+zDB/gkJ7+bILpCu1+f95W+6eINd+ng=="
       },
       "sellerOrderNumber": "Vicky_1791515806477",
       "promotionCriteria": {
           "promotionCode": ""
       },
       "serviceOrders": [
           {
               "serviceType": "Sport Equipment",
               "paxIndex": 1,
               "serviceOfferId": "35f9d2cf-9b1e-6c34-f4b1-a9c6886091e8"
           },
           {
               "serviceType": "Sport Equipment",
               "paxIndex": 2,
               "serviceOfferId": "35f9d2cf-9b1e-6c34-f4b1-a9c6886091e8"
           },
           {
               "serviceType": "Meal",
               "sellerOrderNumber": "",
               "totalAmount": "-0.15",
               "serviceTrip": {
                   "onwardTrip": {
                       "segmentSequences": [
                           1
                       ]
                   }
               },
               "paxIndex": 1,
               "serviceLeg": {},
               "currency": "USD",
               "serviceOfferId": "4d84f39c-1f76-2b9f-9ed5-3420aee97cfa"
           },
           {
               "serviceType": "Meal",
               "sellerOrderNumber": "",
               "totalAmount": "-0.15",
               "serviceTrip": {
                   "onwardTrip": {
                       "segmentSequences": [
                           1
                       ]
                   }
               },
               "paxIndex": 2,
               "serviceLeg": {},
               "currency": "USD",
               "serviceOfferId": "4d84f39c-1f76-2b9f-9ed5-3420aee97cfa"
           },
           {
               "serviceType": "Seat",
               "totalAmount": "0.00",
               "data": {
                   "seat": {
                       "designator": "20C",
                       "rowNo": "20",
                       "colNo": "C",
                       "deck": "Main",
                       "seatId": "57ed0f52-4c31-30bd-ff6b-a669055d6d11",
                       "seatTypes": [
                           "AISLE"
                       ]
                   }
               },
               "serviceTrip": {
                   "onwardTrip": {
                       "segmentSequences": [
                           1
                       ]
                   }
               },
               "paxIndex": 1,
               "currency": "USD",
               "serviceOfferId": "57ed0f52-4c31-30bd-ff6b-a669055d6d11"
           },
           {
               "serviceType": "Seat",
               "totalAmount": "0.00",
               "data": {
                   "seat": {
                       "designator": "20D",
                       "rowNo": "20",
                       "colNo": "D",
                       "deck": "Main",
                       "seatId": "f40c077e-fd06-3b3b-0233-0cdbd21435d8",
                       "seatTypes": [
                           "AISLE"
                       ]
                   }
               },
               "serviceTrip": {
                   "onwardTrip": {
                       "segmentSequences": [
                           1
                       ]
                   }
               },
               "paxIndex": 2,
               "currency": "USD",
               "serviceOfferId": "f40c077e-fd06-3b3b-0233-0cdbd21435d8"
           }
       ],
       "pricedOffer": {
           "offerId": "ad4868c04b5745ebbbec76d69093b193",
           "refTripKey": "TBdlisxuDmfz9NmyDmzBtlayb/e99DIA6PvDL0ySud39nHfdwrZFgBU1iv3AQNtbt/JvKA6OU2Vr+3uu2d9TXzDuKWlF9buoHpSYZ0iHiyvHUqv8uEViYkid5C3bKNq38+coF9JTfT0o/b2fEGOdSLRyGHrHujDCi4aSjdo+zDB/gkJ7+bILpCu1+f95W+6eINd+ng==",
           "fareType": "Corporate Fare"
       },
       "bundleOrders": [
           {
               "paxIndexList": [
                   1,
                   2
               ],
               "bundleOfferId": "37348711-00cc-b3e0-066a-6346b83e1dad"
           }
       ]
   },
   "paxList": [
       {
           "identityDoc": {
               "expiryDate": "2031-10-09",
               "genderCode": "M",
               "identityDocTypeCode": "P",
               "issueDate": "2024-10-09",
               "identityDocId": "E94379694",
               "issuingCountryCode": "CN",
               "birthDate": "1928-09-20"
           },
           "paxType": "ADT",
           "redress": "redress",
           "ktn": "ktn",
           "individual": {
               "genderCode": "M",
               "titleName": "Mr",
               "surname": "Lewis",
               "givenName": "Martha",
               "middleName": "Karen",
               "birthDate": "1928-09-20",
               "citizenshipCountryCode": "CN",
               "age": 98
           },
           "paxIndex": 1
       },
       {
           "identityDoc": {
               "expiryDate": "2031-10-09",
               "genderCode": "F",
               "identityDocTypeCode": "P",
               "issueDate": "2024-10-09",
               "identityDocId": "E70935388",
               "issuingCountryCode": "CN",
               "birthDate": "1954-05-17"
           },
           "paxType": "ADT",
           "redress": "redress",
           "ktn": "ktn",
           "individual": {
               "genderCode": "F",
               "titleName": "Ms",
               "surname": "Clark",
               "givenName": "Mary",
               "middleName": "Paul",
               "birthDate": "1954-05-17",
               "citizenshipCountryCode": "CN",
               "age": 72
           },
           "paxIndex": 2
       }
   ],
   "contactInfos": [
       {
           "emailAddress": "vicky.li@gdn.com",
           "individual": {
               "genderCode": "F",
               "titleName": "Ms",
               "address": "625 Liberty Road, void, China",
               "city": "Qingdao",
               "surname": "Walker",
               "givenName": "Brenda",
               "middleName": "",
               "birthDate": "2000-09-20",
               "citizenshipCountryCode": "CN",
               "age": 26
           },
           "phone": {
               "phoneNumber": "+351 15460810594",
               "contactTypeText": "Passenger"
           },
           "contactType": "Primary Contact"
       },
       {
           "emailAddress": "contact66814247@gdn.com",
           "individual": {
               "genderCode": "F",
               "titleName": "Ms",
               "address": "625 Liberty Road, void, China",
               "city": "Qingdao",
               "surname": "Nguyen",
               "givenName": "Virginia",
               "middleName": "",
               "birthDate": "1975-01-12",
               "citizenshipCountryCode": "CN",
               "age": 51
           },
           "phone": {
               "phoneNumber": "+351 18381006243",
               "contactTypeText": "Passenger"
           },
           "contactType": "Secondary Contact"
       },
       {
           "emailAddress": "contact95174226@gdn.com",
           "individual": {
               "genderCode": "F",
               "titleName": "Ms",
               "address": "625 Liberty Road, void, China",
               "city": "Qingdao",
               "surname": "Harris",
               "givenName": "Janet",
               "middleName": "",
               "birthDate": "1992-03-18",
               "citizenshipCountryCode": "CN",
               "age": 34
           },
           "phone": {
               "phoneNumber": "+351 18473564547",
               "contactTypeText": "Passenger"
           },
           "contactType": "Emergency Contact"
       }
   ]
}

Request Payload Structure

Key	Parent	Type	Mandatory/Optional	Description
createOrder	root	Object	M
currency	createOrder	String	O	[Since v2.0] The currency field defines the settlement and pricing currency for the order being created. All subsequent transactions (payments, invoicing, refunds, and adjustments) will be based on this currency. It's not mandatory for single-currency quotes but mandatory for multi-currency quotes
tripsInfo	createOrder	Object	O
tripKey	tripsInfo	String	M
onwardTrip	tripsInfo	Object	M
segmentInfo	onwardTrip	Array	M
segmentSequence	segmentInfo	Int	M
flightDesignator	segmentInfo	Object	M
marketingCarrier	flightDesignator	Object	M
marketingCarrierCode	marketingCarrier	String	M
marketingFlightNumber	marketingCarrier	String	M
departureInfo	segmentInfo	Object	M
departureDate	departureInfo	String	M
departureTime	departureInfo	String	M
airportCode	departureInfo	String	M
arrivalInfo	segmentInfo	Object	M
arrivalDate	arrivalInfo	String	M
arrivalTime	arrivalInfo	String	M
airportCode	arrivalInfo	String	M
returnTrip	tripsInfo	Object	O
pricedOffer	createOrder	Object	M
offerId	pricedOffer	String	M	offerId that used in offerPrice
cabinClass	pricedOffer	String	O
totalPrice	pricedOffer	Object	O	Total flight price
passengerFares	pricedOffer	Array	O
paxType	passengerFares	String	O
price	passengerFares	Object	O
fareComponents	passengerFares	Array	O
onwardTrip	fareComponents	Object	O
segmentInfos	onwardTrip	Array	O
segmentSequence	segmentInfos	Int	M
bookingCode	segmentInfos	String	M
returnTrip	fareComponents	Object	O
promotionCriteria	createOrder	Object	O	A Promotion and discount code criteria to be passed to the retailer airline that could influence returned offers
promotionCode	promotionCriteria	String	O	The promo code provided in the OderCreate request must match the promo code returned in the Offerprice response. If omitted, the promo code returned by Offerprice will be used by default.
sellerOrderNumber	createOrder	String	M	Seller order number that generated in external seller system
serviceOrders	createOrder	Array	O
serviceOfferId	serviceOrders	String	M	The unique identifier of the service offer obtained from the serviceList or seatAvailability response
serviceType	serviceOrders	String	M	The category type of the ancillary service being ordered The category of the ancillary service： Baggage Meal Priority Boarding Special Assistance Seat Selection Sport Equipment Carbon Offset
totalAmount	serviceOrders	String	O
currency	serviceOrders	String	O
sellerOrderNumber	serviceOrders	String	O	Seller order number that generated in external seller system
paxIndex	serviceOrders	String	M	The index number of the passenger (from the paxList array) to whom this service applies.
serviceTrip	serviceOrders	Object	O
onwardTrip	serviceTrip	Object	O
segmentSequence	onwardTrip	Array	O	Segment sequence numbers in the onward trip that this service applies to
returnTrip	serviceTrip	Object	O
segmentSequence	onwardTrip	Array	O	Segment sequence numbers in the return trip that this service applies to
serviceLeg	serviceOrders	Object	O
legSequence	serviceLeg	String	O
data	serviceOrders	Object	O
baggageAssociations	data	Object	O	This node is ONLY present when serviceType = 'BAGGAGE'. Contains baggage-specific details
baggageId	baggageAssociations	String	O
typeCode	baggageAssociations	String	O	Type of baggage CheckedIn CarryOn
descText	baggageAssociations	String	O
maximumDimensionAllowance	baggageAssociations	Object	O
heightMeasure	maximumDimensionAllowance	String	O	Maximum allowed height of the baggage
lengthMeasure	maximumDimensionAllowance	String	O	Maximum allowed length of the baggage.
linearMeasure	maximumDimensionAllowance	String	O	Maximum allowed linear dimensions (sum of dimensions)
widthMeasure	maximumDimensionAllowance	String	O	Maximum allowed width of the baggage
unitOfMeasurement	maximumDimensionAllowance	String	O	Unit of measurement for dimensions (e.g., CM, IN)
pieceAllowance	baggageAssociations	Object	O
totalQty	pieceAllowance	String	O	Total number of baggage pieces allowed
weightAllowance	baggageAssociations	String	O
maximumWeightMeasure	weightAllowance	String	O	Maximum allowed weight per baggage piece
weightUnitOfMeasurement	weightAllowance	String	O	Unit of measurement for weight (e.g., KG, LB)
seat	data	Object	O
seatId	seat	String	O
designator	seat	String	O	Referred to as airline code
deck	seat	String	O	Indicates the level or deck of the aircraft where the seat is located. Main: for the primary cabin deck Upper: for the upper deck
rowNo	seat	String	O	Specifies the row number of the seat
colNo	seat	String	O	Specifies the column position or seat letter within the row
seatTypes	seat	Array	O	The characteristics and features of the seat. This field uses standardized codes: WINDOW AISLE EXIT MIDDLE EXTRA_LEG_ROOM HANDICAP_ACCESSIBLE: wheelchair accessible seat
bundleOrders	createOrder	Array	O	Contains all bundle purchase information for the order. This array groups together bundle selections and their passenger assignments.
bundleOfferId	bundleOrders	String	M	The unique identifier of the bundle offer being purchased. This ID is obtained from the bundleAvailability API response
paxIndex	bundleOrders	Array	M	Specifies which passengers in the booking are included in this bundle purchase.
sellerOrderNumber	bundleOrders	String	O	Seller order number that generated in external seller system
paxList	root	Array	M
paxType	paxList	String	M	Passenger Type Code: ADT TEEN CHD INF *Note: Different airlines may have varying pax type classifications and age definitions for each type. DerbySoft will provide a reference library of airline-specific passenger age criteria for Sellers. If a pax type requested by the Seller (e.g., TEEN) is not supported by the Supplier, DerbySoft will map the Seller’s requested type to a corresponding type supported by the Supplier.
paxIndex	paxList	Int	M	Assign a passenger index starting from 1(i.e., 1, 2, 3, and so on)
associatedPaxIndex	paxList	Int	O	This node is used to assign the adult to whom the child is linked when the passenger type is “INF” If empty, the infant will by default be linked to the first ADT in the itinerary.
individual	paxList	Object	M
age	individual	String	O
birthDate	individual	String	M
genderCode	individual	String	M	F=female M=male X=others
givenName	individual	String	M
surname	individual	String	M	Family/Lastname of the Pax
middleName	individual	String	O
titleName	individual	String	M	A word such as Mr., Mrs., Miss or Dr that is used before an individual's name to indicate the gender, profession or marital status
citizenshipCountryCode	individual	String	M
city	individual	String	O
address	individual	String	O
loyaltyProgramAccount	paxList	Object	O
accountNumber	loyaltyProgramAccount	String	O
carrier	loyaltyProgramAccount	String	O
programName	loyaltyProgramAccount	String	O
programCode	loyaltyProgramAccount	String	O
identityDoc	paxList	Object	O	Use the passengerIdentifyDocumentsRequired flag returned by the offerPrice endpoint to determine whether the order can be created without passenger documents; if the flag is true, the passenger information in this node is mandatory.
identityDocTypeCode	identityDoc	String	M	Travel Document Types P: Passport OFW: Overseas Filipino Workers PWD: Person with Disability (Filipino Citizen only). PWD Identification Card Number. SCP: Senior Citizen Passenger (Filipino Citizen only).Requires a valid Senior Citizen ID Card Number.
identityDocId	identityDoc	String	M
expiryDate	identityDoc	String	O
issuingCountryCode	identityDoc	String	O
issueDate	identityDoc	String	O
birthDate	identityDoc	String	O
genderCode	identityDoc	String	O
ktn	paxList	String	O	The expedited screening program in the United States
redress	paxList	String	O	The Rapid Screening Program Auxiliary identification number in the United States
contactInfos	root	Array	M	Can support multiple contact information
individual	contactInfos	Object	O
age	individual	String	O
birthDate	individual	String	O
genderCode	individual	String	M	F=female M=male X=others
givenName	individual	String	M
surname	individual	String	M	Family/Lastname of the Pax
middleName	individual	String	O
titleName	individual	String	O	A word such as Mr., Mrs., Miss or Dr that is used before an individual's name to indicate the gender, profession or marital status
citizenshipCountryCode	individual	String	O
emailAddress	contactInfos	String	M
phone	contactInfos	Object	O
contactTypeText	phone	String	O	Recommended for indicating the contact type, such as below value: Passenger OTA
phoneNumber	phone	String	O	Format: country code followed by a space and the phone number, e.g. +86 18700000000
contactType	contactInfos	String	O	GST Primary Contact Secondary Contact: [Since v2.0] Emergency Contact: [Since v2.0] Note: if leave as blank, default be primary contact
customerNumber	contactInfos	String	O	Identifier for the customer or business. For GST contact type, this holds the GSTIN (15‑character alphanumeric). For primary contact, leave as blank
companyName	contactInfos	String	O	Legal name of the business registered under the identifier.
address	contactInfos	Object	O	Structured address of the business. Contains the sub‑fields below.
lineOne	address	String	O	House/building number and street name (usually mandatory)
lineTwo	address	String	O	Additional address details like floor, unit, apartment, or sub-locality.
lineThree	address	String	O	Optional landmark, cross street, or postal box
countryCode	address	String	O	alpha‑2 country code (2 letters)
provinceState	address	String	O
cityCode	address	String	O
postalCode	address	String	O	Postal or ZIP code
payment	root	Object	O	The payment must match one of the supplier accepted payment methods
amount	payment	String	M	Amount to be charged to this payment method
paymentCurrency	payment	String	M
paymentGateway	payment	String	O	Enumeration: Direct: pay directly to airline/suppliers DSPAY: 3rd party payment service
paymentMethod	payment	Object	O
paymentMethod	paymentMethod	String	O	[Since v2.0] This field indicates the settlement method used for the order. It enables the purchasing agent to explicitly choose between cash‑based (wallet / BSP settlement) and card‑based payment, or other alternative methods, when the transaction supports multiple payment channels. If empty, default will be WALLET. Enumeration List WALLET – Airline / supplier wallet (e.g., IATA EasyPay). Pre‑funded electronic wallet; funds are blocked at the time of ticket issuance. No card details are required. BSP_CASH – BSP cash settlement. The sale is reported as cash and settled via the BSP (Billing and Settlement Plan) according to IATA’s standard settlement timelines. No card details are required. CARD – Payment card (credit or debit). This value requires the PaymentCard sub‑object to be present with valid card details (e.g., card number, expiration date, cardholder name). VOUCHER – Payment using a voucher or travel certificate. BANK_TRANSFER – Payment via bank transfer (wire transfer). LOYALTY_REDEMPTION – Frequent flyer miles or loyalty program redemption. OTHER – Other payment methods not covered by the above values. This is an extensible placeholder for future additions.
paymentCard	paymentMethod	Object	O	When the payment method is cash, this node does not need to be completed
cardBrandCode	paymentCard	String	M	Enumeration: VI: Visa MC: Master Card AX: American Express BC: Bank Card BL: Carte Bleu CB: Carte Blanche DN: Diners Club DS: Discover Card EC: Euro card JC: Japanese Credit Bureau Credit Card TP: Universal Air Travel Card CU: China UnionPay MA: Maestro Card
cardNumber	paymentCard	String	M	Credit card number
cardSecurityCode	paymentCard	String	M	Card CVC/CVV number
cardType	paymentCard	String	M	Enumeration: 1: CREDIT 2: DEBIT 3: CENTRAL_BILL
cardHolderName	paymentCard	String	M	Name of cardholder, as it appears on the card
expirationDate	paymentCard	String	M	Card expiration time YYYY-MM-DD
payer	payment	Object	O	When the payment method is card, this node is mandatory
payerName	payer	Object	O
givenName	payerName	String	M
surname	payerName	String	M	Family/Lastname of the Pax
middleName	payerName	String	O
titleName	payerName	String	O
phone	payer	Object	O
contactTypeText	phone	String	O	Recommended for indicating the payer type, such as below value: Passenger OTA
phoneNumber	phone	String	O

Response - OrderViewRS

Key	Parent	Type	Mandatory/Optional	Description
orderView	root	Object	O
order	orderView	Object	M
orderId	order	Object	M
supplierOrderId	orderId	String	M	Use this parameter when adding seats after a ticket has been issued (post-booking). It references the existing, confirmed order
gdnOrderId	orderId	String	O
info	order	Object	M
orderStatus	info	String	M	please refer to order status enumeration table
createdDate	info	String	M	yyyy-mm-dd hh:mm:ss, UTC
modifiedDate	info	String	M	yyyy-mm-dd hh:mm:ss, UTC
paymentStatus	info	String	M	unpaid processing paid cancelled failed
totalPrice	order	Object	O	Order total price
totalAmount	totalPrice	String	M
currency	totalPrice	String	M
supplier	order	Object	O
supplierName	supplier	String	O
airlineCode	supplier	String	O
agencyCode	supplier	String	O
technicalCapabilities	supplier	Array	O	node provides critical information about the technical execution methods and support channels available for post-booking operations with this specific supplier. This allows you to understand how different modification requests (e.g., refunds, changes) are handled behind the scenes and set the correct user expectations
operationType	technicalCapabilities	String	M	The type of post-booking operation. This field identifies which specific operation the technical details apply to (e.g., refunding a ticket, changing a flight). It scopes the context for the subsequent technical fields. DIRECT_REFUND ESTIMATED_REFUND CHANGE_FLIGHT_TIME UPDATE_PASSENGER_NAME ADD_ANCILLARY
method	technicalCapabilities	String	M	How the operation is technically executed. Key values: NATIVE_API: The supplier provides a direct, automated API. DS_AI_AGENT: Automation is enabled via an AI agent (e.g., RPA, robotic process).Note: This automated service may involve additional fees charged to the seller. MANUAL: The operation cannot be processed automatically. The seller must handle it offline by contacting the supplier or airline directly through their own channels
automationLevel	technicalCapabilities	String	M	The degree of automation. This field provides a high-level, intuitive summary of the method FULL PARTIAL NONE
apiAvailability	technicalCapabilities	String	M	This provides granular technical detail for integrators when the method is NATIVE_API REALTIME: A synchronous API that provides immediate results ASYNC: An asynchronous API; a request is submitted, and the result must be polled for later.
paxList	orderView	Array	M
paxType	paxList	String	M	ADT TEEN CHD INF
paxIndex	paxList	Int	M	passenger index starting from 1(i.e., 1, 2, 3, and so on)
ticketNumber	paxList	Object	O	Passenger ticket number information
loyaltyProgramAccount	paxList	Object	O
identityDoc	paxList	Object	O
birthDate	identityDoc	String	O
genderCode	identityDoc	String	O
identityDocTypeCode	identityDoc	String	O
expiryDate	identityDoc	String	O
issuingCountryCode	identityDoc	String	O
issueDate	identityDoc	String	O
identityDocId	identityDoc	String	O
onwardTrips	ticketNumber	Array	M
segmentSequence	onwardTrips	String	M
ticketNumber	onwardTrips	String	M
returnTrips	ticketNumber	Array	O
airlinePnr	paxList	Object	O	Passenger airline pnr information
onwardTrips	airlinePnr	Array	M
segmentSequence	onwardTrips	String	M
airlinePnr	onwardTrips	String	M
returnTrips	airlinePnr	Array	O
individual	paxList	Object	O
givenName	individual	String	O
surname	individual	String	O
middleName	individual	String	O
titleName	individual	String	O
age	individual	Int	O
birthDate	individual	String	O
genderCode	individual	String	O
citizenshipCountryCode	individual	String	O
flightInfos	orderView	Array	O
booking	flightInfo	Object	M	Booking id for flight order, for most suppliers, it’s same with orderId
supplierBookingId	booking	String	M
gdnBookingId	booking	String	O
info	flightInfo	Object	M
orderStatus	info	String	M	Flight order status, please refer to order status enumeration table
createdDate	info	String	M
modifiedDate	info	String	M
paymentStatus	info	String	M	Unpaid Processing Success Cancelled Failed
offer	flightInfo	Object	M	Same offer object as returned by the offerPrice endpoint
totalPrice	offer	Object	M
totalAmount	totalPrice	String	M	The final total amount payable by the passenger. Calculation formula: TotalBaseAmount + TotalTaxFeeAmount + totalServiceFeeAmount
totalBaseAmount	totalPrice	String	M	The price of the flight ticket itself, excluding taxes and service fees. When PriceType is Gross, this amount includes commission.
totalTaxFeeAmount	totalPrice	String	M	The sum of all tax items, equal to the sum of amounts in TaxFeeDetail.
taxFeeDetails	totalPrice	Object	O
code	taxFeeDetails	String	O	The tax name
taxCode	taxFeeDetails	String	O	[Since v2.0]The code of tax
amount	taxFeeDetails	String	O
type	taxFeeDetails	String	O	Enum values: AirlineTax - Standard airline taxes VAT - Value added tax Other - Other tax types
totalServiceFeeAmount	totalPrice	String	O
serviceFeeDetails	totalPrice	Array	O
code	serviceFeeDetails	String	O	All service fees related to flight booking - including those charged by non-airline suppliers, DerbySoft.
amount	serviceFeeDetails	String	O
type	serviceFeeDetails	String	O	Enum values: Supplier - Supplier service fee DS - DerbySoft service fee
includedInTotal	serviceFeeDetails	String	O	true - Already included in TotalAmount false - Not included in TotalAmount, requires additional payment
currency	totalPrice	String	M
promotionDetailInfo	totalPrice	Object	O	[Since v2.0]Promotion details recorded for the flight order total fare. Returned when a promotion was applied.
promoCode	promotionDetailInfo	String	M	[Since v2.0]The promotion code applied to this order fare.
originalBaseAmount	promotionDetailInfo	String	M	[Since v2.0]The order total base fare amount before the promotion discount is applied.
discountAmount	promotionDetailInfo	String	M	[Since v2.0]The order total discount amount applied to the original base fare amount.
currency	promotionDetailInfo	String	M	[Since v2.0]
brandFareName	offer	String	M	[Since v2.0]
brandFareUrl	offer	String	O
brandFareCode	offer	String	O	[Since v2.0]Brand Fare Identifier Code. Replaces airline-specific concepts like bundleCode. Represents the machine-readable code of the branded fare tier (e.g., "HFL" for premium flex)
fareType	offer	String	O	[Since v2.0]
timeLimits	offer	Object	M
paymentExpirationDateTime	timeLimits	String	O
passengerFares	offer	Array	M
paxType	passengerFares	String	M
price	passengerFares	Object	O
baseAmount	price	String	O
currency	price	String	O
taxFeeAmount	price	String	O
taxFeeDetails	price	Array	O
code	taxFeeDetails	String	O	The tax name
taxCode	taxFeeDetails	String	O	[Since v2.0] The tax code
amount	taxFeeDetails	String	O
type	taxFeeDetails	String	O	Enum values: AirlineTax - Standard airline taxes VAT - Value added tax Other - Other tax types
totalAmount	price	String	O
totalServiceFeeAmount	price	String	O
serviceFeeDetails	price	Array	O
code	serviceFeeDetails	String	O	All service fees related to flight booking - including those charged by non-airline suppliers, DerbySoft.
amount	serviceFeeDetails	String	O
type	serviceFeeDetails	String	O	Enum values: Supplier - Supplier service fee DS - DerbySoft service fee
includedInTotal	serviceFeeDetails	String	O	true - Already included in TotalAmount false - Not included in TotalAmount, requires additional payment
currency	totalPrice	String	M
priceType	totalPrice	String	O	Enum values: Net - Net price, base fare excludes commission Gross - Gross price, base fare includes commission
promotionDetailInfo	price	Object	O	[Since v2.0] Promotion details recorded for this passenger fare. Returned when a promotion was applied.
promoCode	promotionDetailInfo	String	M	[Since v2.0] The promotion code applied to this passenger fare.
originalBaseAmount	promotionDetailInfo	String	M	[Since v2.0] The passenger base fare amount before the promotion discount is applied.
discountAmount	promotionDetailInfo	String	M	[Since v2.0] The discount amount applied to the original passenger base fare amount.
currency	promotionDetailInfo	String	M
passengerIdentifyDocumentsRequired	passengerFares	Boolean	M
fareComponents	passengerFares	Array	M
onwardTrip	fareComponents	Object	M
segmentInfos	onwardTrip	Array	M
segmentSequence	segmentInfos	String	O
fareBasisCode	segmentInfos	String	O
bookingCode	segmentInfos	String	O
amenities	segmentInfos	Object	O
wifi	amenities	Object	O
available	wifi	String	O	Boolean value: true/false
seat	amenities	Object	O
type	seat	String	O
legroom	seat	String	O
power	amenities	Object	O
available	power	String	O	Boolean value: true/false
conditions	onwardTrip	Array	O
freeServices	onwardTrip	Array	O
serviceType	freeServices	String	O	The category of the ancillary service： Meal Priority Boarding Special Assistance Seat Sport Equipment Carbon Offset
desc	freeServices	String	O
serviceName	freeServices	String	O	[Since v2.0]
needSelection	freeServices	String	O	[Since v2.0] Selection Requirement Indicator. Indicates whether the included complimentary service requires explicit selection during booking or pre-booking (e.g., true for choosing seat designator/meal type; false for automatic benefits like priority boarding).
ssrCode	freeServices	String	O	[Since v2.0] Standard SSR Code. Transparently carries the underlying Special Service Request code
limitedPerPsg	freeServices	String	O	[Since v2.0]
freeBaggages	onwardTrip	Array	O
typeCode	freeBaggages	String	O
descText	freeBaggages	String	O
ssrCode				[Since v2.0]
maximumDimensionAllowance	freeBaggages	Object	O
heightMeasure	maximumDimensionAllowance
lengthMeasure	maximumDimensionAllowance
linearMeasure	maximumDimensionAllowance
widthMeasure	maximumDimensionAllowance
unitOfMeasurement	maximumDimensionAllowance
pieceAllowance	freeBaggages
totalQty	pieceAllowance
weightAllowance	freeBaggages
maximumWeightMeasure	weightAllowance
weightUnitOfMeasurement	weightAllowance
totalWeightMeasure	weightAllowance
price	onwardTrip	Object	O	[Since v2.0] Added to return onward trip price and return trip price. The structure is same with passengerFare.price
returnTrip	fareComponents	Object	O
tripsInfo	flightInfo	Object	M	Same tripsInfo object as returned by the offerPrice endpoint
paxIndexList	flightInfo	Array	O	An array containing the indices of passengers from the paxList who are associated with this specific flight itinerary. Note: this field is only returned when passengers within the same order have different flight itineraries(e.g., partially change flight time). If all passengers in the order share the identical itinerary, this field will not return.
serviceInfos	orderView	Array	O	Same serviceInfo object in the orderCreate request
bundleInfos	orderView	Array	O	Same bundleInfo object in the orderCreate request
contactInfos	orderView	Array	O	Same contactInfos object in the orderCreate request
payments	orderView	Array	O
createdDate	payments	String	M	The timestamp when the payment record was initially created yyyy-mm-dd hh:mm:ss, UTC
modifiedDate	payments	String	M	The timestamp when the payment record was last updated yyyy-mm-dd hh:mm:ss, UTC
paymentKey	payments	String	O	A unique identifier for this specific payment transaction
paymentTypeCode	payments	String	O	Cash Card
paymentStatus	payments	String	M	unpaid processing paid cancelled failed
totalPrice	payments	Object	M
totalAmount	totalPrice	String	M
currency	totalPrice	String	M
paymentGateway	payments	String	O	Enumeration: Direct: pay directly to airline/suppliers DSPAY: 3rd party payment service
refModificationId	payments	String	O
paymentMethod	payments	String	O	[Since v2.0] This field indicates the settlement method used for the order. It enables the purchasing agent to explicitly choose between cash‑based (wallet / BSP settlement) and card‑based payment, or other alternative methods, when the transaction supports multiple payment channels. If empty, default will be WALLET. Enumeration List WALLET – Airline / supplier wallet (e.g., IATA EasyPay). Pre‑funded electronic wallet; funds are blocked at the time of ticket issuance. No card details are required. BSP_CASH – BSP cash settlement. The sale is reported as cash and settled via the BSP (Billing and Settlement Plan) according to IATA’s standard settlement timelines. No card details are required. CARD – Payment card (credit or debit). This value requires the PaymentCard sub‑object to be present with valid card details (e.g., card number, expiration date, cardholder name). VOUCHER – Payment using a voucher or travel certificate. BANK_TRANSFER – Payment via bank transfer (wire transfer). LOYALTY_REDEMPTION – Frequent flyer miles or loyalty program redemption. OTHER – Other payment methods not covered by the above values. This is an extensible placeholder for future additions.
modificationHistories	orderView	Array	O	The modificationHistory node provides a complete audit trail of all post-booking changes and refund requests made to an order. It allows you to track the status, scope
modificationId	modificationHistory	String	M	A unique identifier for this specific modification request.
modificationType	modificationHistory	String	M	The category of the modification CHANGE_FLIGHT_TIME UPDATE_PASSENGER_NAME ADD_ANCILLARY PARTIAL_REFUND REFUND SSR_UPGRADE SEAT_REASSIGN
requestedDateTime	modificationHistory	String	M	The timestamp when the request was initially submitted
initiatedBy	modificationHistory	String	M	USER SYSTEM
modificationStatus	modificationHistory	Object	M
modificationStatus	modificationStatus	String	M	REQUEST_RECEIVED PROCESSING REJECTED COMPLETED CANCELLED FAILED
modificationRemark	modificationStatus	Array	M	Provides additional details or reason for the current modification status.
scope	modificationHistory	Object	O	Defines the exact parts of the order affected by this request
affectedPassengers	scope	Array	O
affectedTrips	scope	Array	O
modificationDetail	modificationHistory	Object	O
updatePassengerName	modificationDetail	Object	O	Same updatePassengerName object as requested by the orderChange endpoint
flightTimeChangeDetail	modificationDetail	Object	O	Same flightTimeChange object as requested by the orderChange endpoint
originalTrip	flightTimeChangeDetail	Object	M	Original trip details before the change.
onwardTrip	originalTrip	Object	M	Original onward trip details.
segmentInfos	onwardTrip	Array	M	Segment information list.
segmentSequence	segmentInfos	Int	M
duration	segmentInfos	Int	M
flightDesignator	segmentInfos	Object	M
marketingCarrier	flightDesignator	Object	M
marketingCarrierCode	marketingCarrier	String	M
marketingCarrierName	marketingCarrier	String	M
marketingFlightNumber	marketingCarrier	String	M
equipmentType	marketingCarrier	String	M
departureInfo	segmentInfos	Object	M
airportCode	departureInfo	String	M
airportName	departureInfo	String	M
terminal	departureInfo	String	M
departureDate	departureInfo	String	M
departureTime	departureInfo	String	M
arrivalInfo	segmentInfos	Object	M
airportCode	arrivalInfo	String	M
airportName	arrivalInfo	String	M
terminal	arrivalInfo	String	M
arrivalDate	arrivalInfo	String	M
arrivalTime	arrivalInfo	String	M
returnTrip	originalTrip	Object	M	Original return trip details. Same segment structure as onwardTrip.
segmentInfos	returnTrip	Array	M
requestedTrip	flightTimeChangeDetail	Object	M	Requested new trip details. Same structure as originalTrip.
onwardTrip	requestedTrip	Object	M	Requested onward trip details. Same structure as original onwardTrip.
segmentInfos	onwardTrip	Array	M
returnTrip	requestedTrip	Object	M	Requested return trip details. Same structure as original returnTrip.
segmentInfos	returnTrip	Array	M
changeOrderInfo	flightTimeChangeDetail	Object	M	Order change summary and price details.
order	changeOrderInfo	Object	M
gdnOrderID	order	String	M
supplierOrderID	order	String	M
supplier	changeOrderInfo	Object	M
supplierName	supplier	String	M
airlineCode	supplier	String	M
agencyCode	supplier	String	M
balanceDue	changeOrderInfo	String	M
originalTotalPrice	changeOrderInfo	Object	M
totalAmount	originalTotalPrice	String	M
currency	originalTotalPrice	String	M
newTotalPrice	changeOrderInfo	Object	M
totalAmount	newTotalPrice	String	M
currency	newTotalPrice	String	M
penaltyAmount	changeOrderInfo	String	M
paxIndexList	flightTimeChangeDetail	Array	M	List of passenger indexes affected by the flight time change.
refundDetail	modificationDetails	Object	O	Present for REFUND or PARTIAL_REFUND types. Contains requested and approved amounts, fees, and a detailed breakdown of what was refunded.
refundAmount	refundDetail	String	O
refundBreakdowns	refundDetail	Array	O
currency	refundDetail	String	O
refundTo	refundDetail	String	O	Specifies the destination method for the refund. This field indicates how the refund amount should be returned to the seller. The available refund methods are strictly dependent on the supplier's or airline's supported refund options. The value provided in this field must be one of the specific methods supported by the relevant carrier for this particular ticket and fare type. original Fop Voucher points
refundReason	refundDetail	String	M
refundType	refundDetail	String	M
refundRequest	refundDetail	Object	M
paxList	refundRequest	Array	M
refundTrip	refundRequest	Object	M
journeySequence	refundTrip	Array	M	Journey sequences to refund 1: outbound trip 2: inbound trip
pointsRecipient	refundDetail	Array	O	Container for loyalty program recipient information. This node is only required when refundTo is set to points
paxIndex	pointsRecipient	String	M	The index number of the passenger (from the paxList array) to whom this service applies.
loyaltyProgramAccount	pointsRecipient	Object	M
accountNumber	loyaltyProgramAccount	String	M
carrier	loyaltyProgramAccount	String	M
programName	loyaltyProgramAccount	String	M
programCode	loyaltyProgramAccount	String	M
refundEstimationInfo	refundDetail	Object	M
refundEstimationId	refundEstimationInfo	String	M
totalPrice	refundEstimationInfo	String	M
totalEstimateAmount	refundEstimationInfo	String	M
isRefundable	refundEstimationInfo	String	M
currency	refundEstimationInfo	String	M
addAncillary	modificationDetails	Object	O
serviceOrders	addAncillary	Array	M
serviceType	serviceOrders	String	M
sellerOrderNumber	serviceOrders	String	M	Seller order number that generated in external seller system
totalAmount	serviceOrders	String	M
serviceTrip	serviceOrders	Object	M
returnTrip	serviceTrip	Object	O
segmentSequences	returnTrip	Array	M
onwardTrip	serviceTrip	Object	M
segmentSequences	onwardTrip	Array	M
paxIndex	serviceOrders	Int	M
serviceLeg	serviceOrders	Object	M
currency	serviceOrders	String	M
serviceOfferId	serviceOrders	String	M
addAncillary	modificationDetails	Object	O
serviceOrders	addAncillary	Array	M
serviceItemId	serviceOrders	String	M	GDN booking ID of the ancillary service order. Used to associate the modification history with orderView.serviceInfos.
ssrUpgrade	modificationDetails	Object	O	[Since v2.0]
serviceItemId	ssrUpgrade	String	M	[Since v2.0] GDN booking ID of the ancillary service order. Used to associate the modification history with orderView.serviceInfos.
seatReassignment	modificationDetails	Object	O	[Since v2.0]
serviceItemId	seatReassignment	String	M	[Since v2.0] GDN booking ID of the ancillary service order. Used to associate the modification history with orderView.serviceInfos.
lastUpdated	modificationHistory	String	O
error	root	Object	O

OrderCreate

Request Payload Example

Request Payload Structure

Response - OrderViewRS