GOgojinko
Post-booking

Commit a flight exchange

Call get_booking first. Use booking_ref and the selected booked_item_id for every servicing action. last_name is required for guest lookup; an owning credential may omit it. The deprecated provider, order_id, provider_reference and provider_booking_id are accepted until 2027-04-30 where the request declares them; a request that sends one is answered with Deprecation and Sunset headers. A 409 item_selection_required returns safe items to choose from.

post/v1/exchange_commit

Request

  • Base URL
    https://api.gojinko.com
  • URL
    https://api.gojinko.com/v1/exchange_commit
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Request body

booking_refstring

Jinko booking reference. Call get_booking first, then select its booked_item_id for servicing.

booked_item_idstring

The booked item, from get_booking items[].booked_item_id. Preserved across exchanges. Omit only when the booking has exactly one item of the requested domain; otherwise a 409 returns items to choose from.

last_namestring

Required for guest lookup. A credential that owns the booking may omit it; ownership is checked by the platform.

order_idstring

Deprecated: name the booking with booking_ref and booked_item_id from get_booking. Names the booking instead of booking_ref, never beside it, and needs a credential that owns the booking. Accepted until 2027-04-30; a request that sends it is answered with Deprecation and Sunset headers.

providerstring

Deprecated: omit it. The platform uses the supplier recorded with the booking. Accepted until 2027-04-30; a request that sends it is answered with Deprecation and Sunset headers.

offer_idstring required
quote_idstring

The quote_id exchange_price returned. Not required. Optional after a refused exchange price, when committing the same offer to request manual handling.

Example request

{
  "booking_ref": "JNK-A0AUR2",
  "last_name": "Doe",
  "offer_id": "exch_offer_3c1a9f",
  "quote_id": "exch_7a1c93f0"
}

Response

Commit a flight exchange

airline_locatorstring

Deprecated: read the item’s supplier_references on POST /v1/get_booking, which carries each airline’s record locator with the airline that issued it. Airline record locator for the current itinerary.

booking_refstring
booking_referencestring

Deprecated: use booking_ref instead. Same value.

new_ticket_numbersstring[]
status'confirmed' | 'pending' | 'partial_failure' | 'failed'

A commit answers pending: the exchange is carried out after this call, whatever the payment outcome. Follow it with exchange_status until it reads confirmed, partial_failure or failed.

payment_outcome'EVEN' | 'ADD_COLLECT' | 'REFUND'

ADD_COLLECT — the customer pays the difference first: send them to checkout_url; the exchange runs only after that payment authorizes. EVEN — nothing to pay. REFUND — the difference goes back to the original payment method once the exchange completes.

checkout_urlstring

Present when payment_outcome is ADD_COLLECT: the page where the customer pays the difference. Nothing is exchanged until that payment authorizes. exchange_status returns the same page while the exchange waits for it.

stripe_checkout_session_urlstring

Deprecated: use checkout_url instead. The same payment page, under a provider’s name.

warningsstring[]

Notes about the booking and its documents, each said once, in words the customer can be shown. A note the supplier sends as free text without a code is left out.

Example response

{
  "airline_locator": "ABC123",
  "booking_ref": "JNK-A0AUR2",
  "booking_reference": "JNK-A0AUR2",
  "new_ticket_numbers": [
    "0012345678901"
  ],
  "status": "pending",
  "payment_outcome": "ADD_COLLECT",
  "checkout_url": "https://app.gojinko.com/checkout?t=eyJyIjoiY2FydCIs…"
}

Changes

No recorded changes to this operation across all 1 revision of this API.