Testing in sandbox

​

Find the test airline

curl -sS -X POST "https://api.sandbox.gojinko.com/v1/flight_search" \
  -H "X-API-Key: $JINKO_SANDBOX_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "JFK",
    "destination": "LHR",
    "departure_date": "'"$DEPARTURE_DATE"'",
    "trip_type": "oneway",
    "include_carriers": ["ZZ"],
    "adults": 1,
    "currency": "USD"
  }'

​

Flights and scenarios

​

What you observe in each scenario

​

Brands

​

Prices

• Base = sum of the legs’ base fares × brand factor × passenger factor.
• Tax = sum of the legs’ taxes. It is the same for every passenger, infants included.

​

Extra bags, seats and meals

• A selection the airline cannot honour never stops the booking. Examples: a second unit of a bag, a child meal for an adult, a seat for a lap infant, or a seat another traveler already holds. The flight is booked and ticketed; that extra alone is marked failed with the airline’s reason.
• Row 13 seat: the ticket is issued, the seat fails with “airline refused the seat”, and Jinko refunds the seat’s price.
• Oversize bag: the ticket is issued and the bag fails with “airline could not add the oversize bag”.
• Void of the booking (ZZ Standard or ZZ Business within 24 hours): the extras’ EMDs are voided with the tickets and the whole charge comes back, extras included. On the refund preview every EMD document carries recoverable: true and the quote carries ancillary_recoverable: true; after commit each EMD reads VOIDED. This is the agency void of a whole order: a void that does not cover every ticket and EMD of the booking is not offered.
• Refund of the booking (ZZ Flex, or ZZ Business after 24 hours): only the flight is refunded. The preview marks each EMD recoverable: false and the quote ancillary_recoverable: false; the EMDs stay ACTIVE, and the refund excludes what was paid for them.
• Exchange: the extras move to the new booking with the same EMD numbers. A seat moves only if the same seat is free on the new flight; otherwise it is marked failed. An exchange from an economy brand to ZZ Business is one example.

​

Refund, void and exchange

​

Refund and void

​

Exchange

difference = new fare − old fare + change fee

​

ZZ6xx and ZZ7xx

• ZZ6xx, refund needs manual handling. The preview is the brand’s normal answer, so you can commit as usual. The airline accepts the request but a person has to settle it: flight_refund_status stays non-terminal, every ticket stays ACTIVE, and no money moves. The test airline never settles it. Use it to test that your integration keeps polling and does not tell the customer the refund failed or completed. On sandbox the operation reads state: "in_progress" for about 20 minutes after commit, then state: "attention_required", waiting for a Jinko operator.
• ZZ7xx, exchange not permitted. Every brand, ZZ Business included, refuses exchanges: exchange shop answers support_level: "UNSUPPORTED" with the reason in warnings. Refunds and voids follow the brand table.

​

Recipes

1. Search. Assert the ZZ Flex fare on flight 101 costs 1062.00 USD (882.00 + 180.00).
2. Book. Assert fulfillment.status is completed.
3. get_booking, then flight_refund_preview. Assert operation_kind: "cancel", refund.amount_money.value 100200 and penalty.amount_money.value 6000 (USD, decimal_places: 2, so 1002.00 and 60.00).
4. Commit with the preview’s refund as acknowledged, then poll status. Assert state: "succeeded" and every ticket REFUNDED, and keep polling until money.vehicle_state is paid or payout_settled: the tickets and the money move independently, and only those two states mean the customer has the money. Sandbox answers payout_settled.

1. Search. Assert the ZZ Standard fare on flight 101 costs 789.00 USD.
2. Book. Assert fulfillment.status is completed.
3. get_booking, then flight_refund_preview. Assert operation_kind: "void", refund.amount_money.value 78900 (USD, decimal_places: 2, so 789.00) and penalty.amount_money.value 0.
4. Commit, then poll status. Assert state: "succeeded" and every ticket VOIDED, and keep polling until money.vehicle_state is paid or payout_settled.

1. Search, then price-check the fare. Assert both return 789.00 USD.
2. Add to a trip and call checkout. On the item, assert price_changed: true, original_price_money.value 78900 and price_money.value 86790 (669.90 + 198.00, each 110 % of the search amount). Money fields are objects whose value is in minor units (decimal_places: 2 for USD).
3. Assert price_change.delta_money.value is 7890 and the checkout total_amount_money.value is 86790.
4. Pay. Assert fulfillment.status is completed, charged at 867.90.

1. Search, add to a trip, call checkout. Assert checkout succeeds.
2. Pay and poll. Assert fulfillment.status ends failed and the customer is not charged.

1. Search, add to a trip, call checkout. Assert checkout succeeds.
2. Pay and poll. Assert fulfillment.status ends failed and the customer is not charged.

1. Book, polling every few seconds.
2. Assert fulfillment.status stays non-terminal for at least 2 minutes.
3. Assert it then reaches completed. Give it up to 5 minutes before failing your test.

1. Book. get_booking, then flight_refund_preview. Assert operation_kind: "cancel", refund.amount_money.value 100200 and penalty.amount_money.value 6000 (USD, decimal_places: 2, so 1002.00 and 60.00).
2. Commit with the preview’s refund as acknowledged.
3. Poll status. Assert it stays non-terminal and every ticket stays ACTIVE.

1. Book. get_booking, then exchange shop with a new preferred_departure_date.
2. Assert support_level: "UNSUPPORTED", a reason in warnings, and no offer you can price.
3. flight_refund_preview still works: assert operation_kind: "void".

1. Search. Assert the ZZ Standard fare on flight 801 costs 789.00 USD.
2. Add to a trip and call checkout. Assert HTTP 410 with error.code: "OFFER_EXPIRED".
3. get_trip. Assert quote.status: "failed", quote.failure_reason: "offer_expired", and no fulfillment.

1. Book. For about 90 seconds, assert fulfillment.status stays non-terminal and the booking’s pnr starts with zzo_ (provisional, not an airline reference).
2. Assert fulfillment.status then reaches completed and pnr is now a 6-character airline reference.
3. get_booking, then flight_refund_preview. Assert operation_kind: "void" and refund.amount_money.value 78900 (789.00 USD).
4. Commit, then poll status. Assert state: "succeeded" and every ticket VOIDED, and keep polling until money.vehicle_state is paid or payout_settled.

1. Search, add to a trip, call checkout. Assert checkout succeeds.
2. Pay and poll. Assert fulfillment.status stays non-terminal for about 90 seconds.
3. Assert it then ends failed with no failure_reason and the customer not charged. pnr still holds the provisional zzo_ value: assert it is not used as an airline reference.

1. Book. get_booking, then exchange shop with a new preferred_departure_date.
2. Price the ZZ Flex offer. Assert total_due is {value: 29800, currency: "USD", decimal_places: 2}, which is 298.00: value is in minor units.
3. Price the ZZ Basic offer. Assert total_refund is {value: 16400, currency: "USD", decimal_places: 2}, which is 164.00. Price the ZZ Standard offer. Assert even.
4. Commit one offer, then poll exchange status. Assert new ticket numbers and the same airline_locator.

1. Search, add the ZZ Standard fare, add travelers, then list ancillaries, polling while the call answers 202 pricing. Assert bag-x1-out at 40.00 USD.
2. Select it for pax_1. Assert total_with_ancillaries is {amount: 82900, currency: "USD", decimal_places: 2}, which is 829.00 (789.00 + 40.00): on this response amount is the integer in minor units.
3. Book. Assert the charge is 829.00 and the ticket is issued.

1. Select bag-ov-out (80.00) for pax_1 and book.
2. Assert the ticket is issued and the bag is marked failed, “airline could not add the oversize bag”.

​

Limits

• Extras. Bags and seats are selectable in sandbox; meals are not listed yet (see Extra bags, seats and meals). Included baggage follows the brand.
• Live search only. Flight calendar, destination discovery and price monitoring never return Jinko Test Air.
• No same-day departures. Jinko Test Air returns nothing for today (UTC) or earlier. With include_carriers: ["ZZ"] the search does not fail: it widens to other carriers and sets include_carriers_widened: true. Search from tomorrow.
• 90-day memory. The test airline forgets a booking’s tickets, refunds and exchanges 90 days after its last change. After that, refunding or exchanging it is refused.
• No reset. Test data is cleared only by that 90-day expiry. Make a new booking for each test run.