Skip to main content
Exchange a booked flight for a different itinerary. No login required — authenticate with the Jinko booking reference and traveler last name. WORKFLOW:
  1. action=“shop” with booking_ref + last_name + optional preferred_departure_date → browse exchange options
  2. action=“price” with booking_ref + last_name + exchange_offer_id → get exact pricing (fare difference, penalties)
  3. If user confirms, action=“commit” with booking_ref + last_name + exchange_offer_id + session_reference → execute the exchange
  4. action=“status” with booking_ref + last_name → poll exchange progress
IMPORTANT:
  • Always shop before pricing, price before committing.
  • Get explicit user confirmation before committing — exchanges may involve fare differences (additional payment or refund).
  • The session_reference from pricing must be passed to commit.

​
Parameters

NameTypeRequiredDescription
actionenum ("shop" | "price" | "commit" | "status")YesAction to perform: “shop” to browse exchange alternatives, “price” to get exact pricing for an offer, “commit” to execute the exchange, “status” to poll exchange progress
booking_refstringYesJinko booking reference (e.g. JNK-A7B3X9). Found in the booking confirmation email.
last_namestringYesLast name of the primary traveler on the booking.
order_idstringNoProvider order ID. Optional — provided only by authenticated DevPlatform callers who already resolved it.
providerstringNoProvider code (e.g., “travelfusion”, “sabre”). Usually auto-detected from the booking.
ticket_numbersarray<string>NoSpecific ticket numbers to exchange (for partial exchanges). Omit for full booking.
exchange_offer_idstringNoExchange offer ID returned from a previous shop action. Required for price and commit actions.
session_referencestringNoSession reference returned from a previous price action. Required for commit action.
preferred_departure_datestringNoPreferred departure date for the new flight (YYYY-MM-DD format). Used with shop action.