DerbySoft GDN Seller API

TABLE OF CONTENTS

OrderCreate

OrderCreate

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.

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

Request Payload Example

Request Payload Example

{
   "createOrder": {
       "sellerOrderNumber": "",
       "serviceOrders": [
           {
               "serviceType": "Baggage",
               "paxIndex": 1,
               "serviceOfferId": "48be7e8d-fc89-461f-9523-b310ed485cf5"
           },
           {
               "serviceType": "Seat",
               "paxIndex": 2,
               "serviceOfferId": "48be7e8d-fc89-461f-9523-b310ed485cf5"
           }
       ],
       "pricedOffer": {
           "offerId": "bb2e32186bdb4048a9a8b02c9902fc29"
       }
   },
   "paxList": [
       {
           "paxType": "ADT",
           "individual": {
               "genderCode": "M",
               "titleName": "Mr",
               "surname": "Rivera",
               "givenName": "Deborah",
               "middleName": "Rebecca",
               "birthDate": "1930-06-04",
               "citizenshipCountryCode": "US"
           },
           "paxIndex": 1
       },
       {
           "paxType": "ADT",
           "individual": {
               "genderCode": "M",
               "titleName": "Mr",
               "surname": "Martinez",
               "givenName": "Jeffrey",
               "middleName": "Frank",
               "birthDate": "1968-03-30",
               "citizenshipCountryCode": "CN",
               "age": 57
           },
           "paxIndex": 2
       }
   ],
   "contactInfos": [
       {
           "emailAddress": "xxxxx@gmail.com",
           "individual": {
               "genderCode": "M",
               "titleName": "Mr",
               "surname": "Lewis",
               "givenName": "Jose",
               "middleName": "",
               "birthDate": "1978-11-27",
               "citizenshipCountryCode": "US"
           },
           "phone": {
               "phoneNumber": "15544525411",
               "contactTypeText": "M"
           }
       }
   ],
   "payment": {
       "amount": "1961.67",
       "paymentCurrency": "USD"
   }
}

Request Payload Structure

createOrder	root	Object	M
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
marketingCarrierDesigCode	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
fareComponent	passengerFares	Array	O
onwardTrip	fareComponent	Object	O
segmentInfo	onwardTrip	Array	O
segmentSequence	segmentInfo	Int	M
bookingCode	segmentInfo	String	M
returnTrip	fareComponent	Object	O
promotionCriteria	createOrder	Objec	O	A Promotion and discount code criteria to be passed to the retailer airline that could influence returned offers
promotionCode	promotionCriteria	String	O	Promotion code ID or number.
sellerOrderNumber	createOrder	String	O	Seller order number that generated in external seller system
serviceOrders	createOrder	Array	O
serviceOfferId	serviceOrder	String	M	The unique identifier of the service offer obtained from the serviceList or seatAvailability response
serviceType	serviceOrder	String	M	The category type of the ancillary service being ordered： Baggage Meal PriorityBoarding SpecialAssitance SeatSelection SportEquipment
totalAmount	serviceOrder	String	O
currency	serviceOrder	String	O
sellerOrderNumber	serviceOrder	String	O	Seller order number that generated in external seller system
paxIndex	serviceOrder	String	M	The index number of the passenger (from the paxList array) to whom this service applies.
serviceTrip	serviceOrder	Object	O
onwardTrip	eligibleTrips	Object	O
segmentSequence	onwardTrip	Array	O	Segment sequence numbers in the onward trip that this service applies to
returnTrip	eligibleTrips	Object	O
segmentSequence	onwardTrip	Array	O	Segment sequence numbers in the return trip that this service applies to
serviceLeg	serviceOrder	Object	O
legSequence	eligibleLeg	String	O
data	serviceOrder	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
descTex	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
seatType	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	M	This node is used to assign the adult to whom the child is linked when the passenger type is “INF”
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
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 false, the passenger information in this node is mandatory.
identityDocTypeCode	identityDoc	String	M	Travel Document Types P: Passport
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	O	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
city	individual	String	O
address	individual	String	O
emailAddress	contactInfos	String	M
contactTypeText	phone	String	O	Recommended for indicating the contact type, such as below value: Passenger OTA
phone	contactInfos	Object	O
phoneNumber	phone	String	O	Format: country code followed by a space and the phone number, e.g. +86 18700000000 Note: AirAsia requires a phone number for order creation. Please ensure you include a telephone number in the orderCreate request.
contactType	contactInfos	String	O	GST Primary Contact 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	String	O	Structured address of the business. Contains the sub‑fields below.
address.lineOne	address	Object	O	House/building number and street name (usually mandatory)
address.lineTwo	address	String	O	Additional address details like floor, unit, apartment, or sub-locality.
address.lineThree	address	String	O	Optional landmark, cross street, or postal box
address.countryCode	address	String	O	alpha‑2 country code (2 letters)
address.provinceState	address	String	O
address.cityCode	address	String	O
address.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
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 values: Passenger OTA
phoneNumber	phone	String	O

Response Schema - 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
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
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
tripsInfo	flightInfo	Object	M	Same `tripsInfo` object as returned by the `offerPrice` endpoint
paxIndex	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
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 REFUND
requestedDateTime	modificationHistory	String	M	The timestamp when the request was initially submitted
initiatedBy	modificationHistory	String	M	USER SYSTEM
modificationStatus	modificationHistory	Object	M
modificationStatus	modificationHistory	String	M	REQUEST_RECEIVED PROCESSING REJECTED COMPLETED CANCELLED
modificationRemark	modificationStatus	String	M	Provides additional details or reason for the current modification status.
modificationDetail	modificationHistory	Object	O
updatePassengerName	modificationDetails	Object	O	Same `updatePassengerName` object as requested by the orderChange endpoint
flightTimeChange	modificationDetails	Object	O	Same `flightTimeChange` object as requested by the orderChange endpoint
originalTrips	flightTimeChange			Original trip details before the change.
onwardTrip	originalTrips	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	originalTrips	Object	M	Original return trip details. Same segment structure as onwardTrip.
segmentInfos	returnTrip	Array	M
requestedTrip	flightTimeChange	Object	M	Requested new trip details. Same structure as originalTrips.
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	flightTimeChange	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	flightTimeChange	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	refundDetails	String	O
refundBreakDowns	refundDetails	Array	O
currency	refundDetails	String	O
refundTo	refundDetails	String	O
refundReason	refundDetails	String	M
refundType	refundDetails	String	M
refundRequest	refundDetails	Object	M
paxList	refundRequest	Array	M
refundTrip	refundRequest	Object	M
journeySequence	refundTrip	Array	M	Journey sequences to refund outbound trip inbound trip
pointsRecipent	refundDetails	Array	O	Container for loyalty program recipient information. This node is only required when refundTo is set to points
paxIndex	pointsRecipent	String	M	The index number of the passenger (from the paxList array) to whom this service applies.
loyaltyProgranAccount	pointsRecipent	Object	M
AccnountNumber	loyaltyProgranAccount	String	M
Carrier	loyaltyProgranAccount	String	M
ProgramName	loyaltyProgranAccount	String	M
ProgramCode	loyaltyProgranAccount	String	M
refundEstimationInfo	refundDetails	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
lastUpdated	modificationHistory	String	O
error	root	Object	O