DerbySoft GDN Seller API

TABLE OF CONTENTS

OrderChange

OrderChange

The OrderChange interface is primarily used by sellers to submit modification requests for a ticket after it has been issued. It currently supports four main types of changes: changing the flight time (itinerary), adding ancillary services, processing refunds, and updating passenger names. This interface allows sellers to manage and confirm post-booking modifications on behalf of their customers

Version	Date	Description of Edit
V1.0	2025/10/22	Initial Commit

Request Details
Path	/api/flight/connectivity/order/orderChange

Request Payload Example

Request Payload Example

{
"order": {
"supplierOrderId": "917603570358296701"
},
"changeOrderChoice": {
"changeFlightTime": {
"requotedOffer": {
"offerId": "80f30d04cf6a48e2a0eaec0969851747"
}
}
},
"payment": {
"amount": "352.06",
"paymentCurrency": "CNY"
}
}

Request Payload Structure

Key	Parent	Type	Mandatory/Optional	Description
order	root	Object	M
supplierOrderId	order	String	M
gdnOrderId	order	String	O
changeOrderChoice	root	Object	M	This object contains the specific change operation to be performed. Only one type of change can be requested per API call. The options are mutually exclusive.
addServices	changeOrderChoice	Object	O	Container for adding ancillary services to the booking
serviceOrder	createOrder	Array	O	List of services to be added
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	M
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. Same baggageAssociations object with serviceListRS
seat	data	Object	O	Same seat object with seatAvailabilityRS
updatePassenger	changeOrderChoice	Object	O	Container for updating passenger information
updatePassengerName	updatePassenger	Array	O
paxIndexList	updatePassengerName	String	M	Index of the passenger to update. This should be get from orderRetrieve
originalPassengerName	updatePassengerName	Object	M	Current passenger name details
givenName	originalPassengerName	String	M
surName	originalPassengerName	String	M
middleName	originalPassengerName	String	O
requestedPassengerName	updatePassengerName	Object	M	New passenger name details
givenName	requestedPassengerName	String	M
surName	requestedPassengerName	String	M
middleName	requestedPassengerName	String	O
changeFlightTime	changeOrderChoice	Object	O	Container for changing flight time or itinerary. Used when requesting a schedule change to a different flight
requotedOffers	changeFlightTime	Array	M
offerId	requotedOffer	String	M	The unique offer ID obtained from the previous flight change search OrderReshopReprice operation. This identifies the specific new flight itinerary being selected
transInfo	requotedOffer	String	O
paxIndexList	requotedOffer	Array	O	List of passenger indexes (from orderRetrieve) who will be changing flights. If not provided, the change applies to all passengers on the booking.
refund	changeOrderChoice	Object	O	Container for refund requests
refundEstimationId	refund	String	O	Reference ID from a prior refund estimation request. This field should only be provided when using the two-step refund process (estimation followed by actual refund request). Leave as empty when doing a direct refund.
refundType	refund	Int	M	Type of refund: 0: voluntary 1: involuntary
refundRequest	refund	Array	O
paxList	refundRequest	Array	M
paxIndex	paxList	String	M	Passengers who you want to refund
refundTrip	refundRequest	Object	M	Trip details for refund.
journeySequence	refundTrip	Array	M	Journey sequences to refund 1: outbound trip 2: inbound trip
refundTo	refund	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. originalFop Voucher points
pointsRecipient	refund	Object	O	Container for loyalty program recipient information. This node is only required when refundTo is set to points
paxIndex	pointsRecipient	String	M
loyaltyProgramAccount	paxList	Object	O
accountNumber	loyaltyProgramAccount	String	O
carrier	loyaltyProgramAccount	String	O
programName	loyaltyProgramAccount	String	O
programCode	loyaltyProgramAccount	String	O
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
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	For example: Visa Master
cardNumber	paymentCard	String	M	Credit card number
cardSecurityCode	paymentCard	String	M	Card CVC/CVV number
cardType	paymentCard	String	M	For example: Visa Visa-debit Visa-connect-debit Mastercard Mastercard-debit
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	payer	String	M
surName	payer	String	M	Family/Lastname of the Pax
middleName	payer	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

orderChange return the same OrderView structure that is produced by orderCreate; no new fields are introduced, so the payload layout documented for the response applies unchanged to this endpoints