GDN V2.0 Migration Hub
Modified on: 2026-10-13 10:49
TABLE OF CONTENTS
- What’s New in GDN Seller API V2.0
- V1.x to V2.0 Minimal Baseline Migration
- 1. Migration Scope Overview
- 2. Key Mandatory Changes 1- AirShopping: Currency Specification
- 3. Key Mandatory Changes 2 - Ancillary Auto-Move Behavior During Flight Exchange
- 4. Key Mandatory Changes 3 - Promotion Code Support
- 5. Key Mandatory Changes 4 - Supplier Error Code Mapping Changes
- 6. Checklist for Engineering Teams
What’s New in GDN Seller API V2.0
GDN Seller API v2.0 introduces significant functional enhancements, expanded rich content capabilities, and deeper post-booking servicing automation.
Important Migration Notice: Full Version Upgrade Required
GDN Seller API v2.0 introduces non-backward compatible payload structures and operational logic. Endpoints between v1.x and v2.0 are completely incompatible and cannot be mixed within the same workflow. To utilize v2.0, Buyers must execute a full upgrade across all integrated endpoints.
V2.0 New Features & API Impact Matrix
The table below outlines all new features and functional enhancements introduced in v2.0 (relative to v1.x), along with their associated API endpoint impacts and key schema additions:
Business Area | New/Enhanced Feature | Capability Description & Business Value | Impacted Endpoints | Key Schema / Payload Additions |
|---|---|---|---|---|
| Pricing & Taxes | Multi-currency quotation with POO price | The system returns quotes in the native Point of Origin (POO) currency along with all eligible wallet settlement currencies available for payment. Buyers can select and lock their preferred currency during order creation. ? For detailed currency resolution scenarios, please refer to the | airShopping offerPrice seatAvailability serviceList bundleAvailability orderCreate | settlementPrices[] |
| Pricing & Taxes | AirShopping Tax Breakdown Return | Returns itemized tax breakdowns directly within initial flight shopping responses. (v1.x only provided total tax amounts without itemized tax details during search). | airShopping | taxCode code |
| Pricing & Taxes | Tax Code Support in Tax Breakdown | Returns official Tax Fee Codes (taxFeeCode) alongside tax amounts across all pricing and order responses. (v1.x only provided generic tax names without standardized tax codes). | airShopping offerPrice seatAvailability serviceList bundleAvailability orderView orderReshop orderReshopReprice | taxCode |
| Pricing & Taxes | Journey-Level Price Splitting | Provides transparent pricing visibility by explicitly splitting and returning individual fares for the onward journey and return journey. | airShopping offerPrice orderView orderReshopReprice | fareComponent.onwardTrip.price fareComponent.returnTrip.price |
| Pricing & Taxes | Promotion Detail | Added promotionDetailInfo under offer totalPrice and passenger fare price to return the promotion code, original base amount, discount amount, and currency. | airShopping offerPrice orderView | airShopping & offerPrice: totoalPrice.promotionDetailInfo totalPrice.settelmentPrice.promotionDetailInfo passengerFare.price.promotionDetailInfo passengerFare.price.settlementPrices.promotionDetailInfo orderView: offer.totalPrice..promotionDetailInfo offer.passengerFare..promotionDetailInfo |
Flight & Itinerary Details | Leg-Level Stopover Details Display | Provides full lifecycle visibility for physical flight legs (e.g., technical stopovers). Returns sequence numbers, leg departure/arrival airports, leg flight durations across shopping, booking, order retrieval. | airShopping offerPrice orderView orderReshop | segmentInfos.legInfos |
Flight & Itinerary Details | Flight Carbon Emission | Returns flight carbon emission data (value & unit) across shopping, pricing, order creation, order view, and flight time change responses. | airShopping offerPrice orderView orderReshop | legInfos.properties[] |
SSR & Bundle | Multi-Meal Selection | Expands meal ancillary options to support selecting up to 2 meals per flight leg for a passenger.(In V1.x version, it only supported 1 meal per leg) | - | - |
SSR & Bundle | New Ancillary Product Type - Carbon Offset | Supports Carbon_Offset as a purchasable journey-level ancillary product | serviceList | - |
SSR & Bundle | Expose Bundle Code | Exposes airline-defined bundle identifiers bundleCode | bundleAvailability orderView | bundleCode |
SSR & Bundle | Expose SSR Code | Exposes standardized airline Special Service Request codes ssrCode | serviceList orderView | ssrCode |
| Seat Selection | Enriched Seat Properties | Expands seat characteristic attributes (seatType enumerations) to support rich seat map displays | seatAvailability | seatTypes[] |
| Seat Selection | Full Seat Map Inventory & Eligibility | Returns full aircraft seat map inventory (including occupied seats) to enable complete front-end cabin map rendering. Includes granular seat eligibility status (occupied, bookable) and operational/safety restriction codes (restrictedPaxTypes for exit row, infant, pregnant, or mobility limits) to control seat locking and front-end warnings. | seatAvailability | seats.seatEligibility |
| Passenger & Contacts | Special Passenger Types (OFW/PWD/SCP) | Supports special passenger demographic type codes,for specialized fare matching.
| orderCreate | identityDocTypeCode |
| Passenger & Contacts | Secondary & Emergency Contacts | Supports capturing secondary contact information and designated emergency contact details during order creation. | orderCreate | contactType |
| MMB | SSR Upgrade | Enables passengers to trade in active booked ancillaries (e.g., 20kg baggage) for higher tiers (e.g., 30kg) by paying only the differential balance. ? See full workflow in | serviceList orderChange orderView |
order.upgradeSSR[]
service.ssrUpgrade unitPrice.upgradePriceDetails
changeorderChoice.ssrUpgrade
modificationDetails.ssrUpgrade |
| MMB | Seat Reassignment | Enables passengers to swap or upgrade seats post-booking in a single flow without requiring prior seat cancellation. ? See full workflow in | seatAvailability orderChange orderView |
order.reassignmentSeat
seats.reassignmentSeat unitprice.reassignmentPriceDetails
changeOrderChoice.seatReassignment
modificationDetails.seatReassignment |
| MMB | Flight Time Change- Ancillary Auto Move | Automatically transfers standalone ancillaries and bundles during voluntary flight change. ?See full workflow in | orderReshop seatAvailability serviceList orderReshopReprice |
offers.impactedServices[]
order.reshopOffer
order.reshopOffer
selectedOffer.serviceOrders
repriceResult.autoCarriedServices[] repriceResult.reselectServices[] |
| MMB | Supporting Document Upload | Enables uploading supporting documentation required for refunds, flight changes and updating passenger info. | uploadDocument | - |
| MMB | Post flight time change ancillary purchase | Enables adding new ancillary services to a flight after a flight change has been executed. (v1.x blocked adding ancillaries on changed flights). | - | - |
| MMB | Full Modification History View | Returns complete, end-to-end modification history records (modificationHistories) in the orderview response, providing full audit visibility into post-booking changes, refunds, and ancillary additions. | orderView | modificationHistory |
| MMB | Conflicting Modification ID in Duplicate Refund Errors | Returns the conflicting active modificationId directly within the error message when a duplicate refund request is repeatedly submitted, enabling downstream systems to immediately query the existing request status. | orderChange | Error message |
| MMB | Flight Time Change Tax Breakdown Return | Returns itemized tax breakdowns directly within orderReshop & orderReshopReprice response. | orderReshop orderReshopReprice | taxFeeDetails |
| Notification | Fulfillment webhook notification | Provide fulfillment webhook notification ? See full workflow in | Webhook | - |
Agency Finance | Agency Wallet Balance Query | Introduces a dedicated API endpoint for agencies to query real-time wallet balances, credit limits, and deposit statuses. | walletBalance | - |
V1.x to V2.0 Minimal Baseline Migration
This guide is designed for buyers seeking a fast, low-effort baseline migration from GDN Seller API v1.x to v2.0 without immediately adopting advanced v2.0 optional capabilities (e.g., Seat Reassignment, Ancillary SSR Upgrades).
Important Version Compatibility Notice: Full API Suite Upgrade Required
GDN Seller API v2.0 introduces breaking structural changes and operational logic. Endpoints between v1.x and v2.0 are completely incompatible and cannot be mixed within the same booking or servicing workflow. To migrate to v2.0, Buyers must upgrade ALL integrated API endpoints to their v2.0 equivalents.
1. Migration Scope Overview
To achieve functional parity when upgrading to API v2.0, your engineering team must update all integrated endpoints. There are 4 primary operational/schema changes to handle during baseline migration:
2. Key Mandatory Changes 1- AirShopping: Currency Specification
In API v1.x, currency selection relies on system-level configuration defaults. In API v2.0, AirShopping requires explicit currency intent inside the request payload under the price.settlement node to guarantee accurate multi-currency quotation and Point of Origin (POO) fare matching.
3. Key Mandatory Changes 2 - Ancillary Auto-Move Behavior During Flight Exchange
In API v1.x, exchanging a flight automatically dropped all previously purchased ancillaries. In API v2.0, ancillary handling rules during voluntary flight exchanges have changed (specifically for Wano supplier connections):
- Automatic Transfer (Bundles & Baggage): Bundles and valid baggage allowances associated with the original booking are automatically transferred and re-associated with the new flight segments.
- Reselection Requirement (Seats & Meals): Previously selected seats and meals are NOT automatically re-mapped. Buyers MUST explicitly reselect new seats and meals within the exchange payload (OrderReshop / OrderChange).
- Spoilage Fee: If new seats or meals are not explicitly reselected during the exchange process, the original seat/meal fees will be forfeited and marked as non-refundable.
For complete step-by-step payloads, exception handling, and detailed exchange workflows, please refer to the dedicate.
4. Key Mandatory Changes 3 - Promotion Code Support
API v2.0 introduces a new type of airline promotion that is activated only when a valid promo code is explicitly provided by the Buyer.
- Mandatory Promo Code Transmission: Buyers must pass the promo code consistently in the AirShopping, OfferPrice, OrderCreate, ConfirmOrder request payloads. When the submitted promo code is valid and the itinerary meets the applicable promotion conditions, the API response will return the discounted price.
- No Automatic Application: If the promo code is not provided, the promotion will not be applied, even when the itinerary would otherwise be eligible. The API will return the regular non-promotional price.
- Migration Requirement: As part of the v2.0 integration, Buyers must support promo code collection and transmission throughout the shopping, pricing, and booking flow. Buyers that do not implement this capability may miss eligible airline promotions and discounted fares.
5. Key Mandatory Changes 4 - Supplier Error Code Mapping Changes
If your integration relies on handling or parsing Supplier-level error codes specifically for WANO supplier connections, please be aware that the Supplier Error Codes returned in API v2.0 for WANO supplier connections have been updated and re-standardized.
- Supplier Error Codes: CHANGED for WANO.
In API v2.0, WANO supplier error codes have been remitted to match updated supplier specs. If your system relies on hardcoded conditions, automated retry logic, or custom user error alerts based on specific WANO supplierErrorCode values, you must update your mapping tables to the new v2.0 WANO error catalog.
- GDN Platform Error Codes: UNCHANGED.
GDN platform-level error codes remain strictly backward-compatible. If your application handles errors exclusively at the GDN standard error level, no code adjustments are required.
6. Checklist for Engineering Teams
- Ensure ALL integrated API endpoints (AirShopping, OfferPrice, OrderCreate, OrderChange, OrderRetrieve, etc.) are upgraded to API v2.0 (Do not mix v1.x and v2.0 endpoints).
- Add the currency field under flightRequests[] in your AirShopping request payloads to specify preferred quotation currency.
- Update flight time change logic to handle ancillary auto-move behavior and enforce seat/meal reselection.
- Support promo code transmission in AirShopping, OfferPrice, OrderCreate, ConfirmOrder requests, and ensure the same promo code is retained throughout the booking flow.
- Perform an end-to-end test run
- Deploy v2.0 baseline integration to Production.
Did you find it helpful? Yes No
Send feedback