Skip to main content
Check refund eligibility, commit a refund, or check refund status for a booked flight. No login required — authenticate with the Jinko booking reference and traveler last name. PREREQUISITES:
  • booking_ref (JNK-XXXXXX format) and last_name of the primary traveler from the booking confirmation email.
WORKFLOW:
  1. action=“check” with booking_ref + last_name → review eligibility, amounts, penalties
  2. If refundable and user confirms, action=“commit” with booking_ref + last_name → capture refund_reference
  3. action=“status” with booking_ref + last_name (+ optional refund_reference) → poll progress
IMPORTANT:
  • Always check eligibility before committing.
  • Always get explicit user confirmation before committing a refund.
  • Some refunds require manual processing — the response flags support_level and is_automatable.
  • Refund amounts may include penalties.

Parameters

NameTypeRequiredDescription
actionenum ("check" | "commit" | "status")YesAction to perform: “check” to check refund eligibility, “commit” to confirm the refund, “status” to poll refund 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 refund (for partial refunds). Omit for full booking refund.
refund_referencestringNoRefund reference ID returned from a previous commit action. Required for status checks.