Getting started · Sandbox

Testing in sandbox

Every account starts in the sandbox: the same host, endpoints, schema and errors as production, against the airlines' test systems.

Sandbox keys

  • A nbr_test_ key runs every request in the sandbox; a nbr_live_ key in production. Both call https://api.norba.io.
  • Orders and webhooks never cross: an order from the other environment answers 404. Orders carry environment, webhooks X-Norba-Environment.
  • Sandbox orders are test bookings. No real ticket is issued.

Test card

Pay sandbox orders with this card in payment.card:

FieldValue
number4111111111111111
expiry_month, expiry_yearAny date in the future.
cvvAny three digits, or omit it.

What it costs

Sandbox bookings and servicing raise no fee. Requests count against your free allowance and are metered as in production: see Pricing.

Suggested routes

Search 2 to 8 weeks ahead. GET /v1/aviation/airlines/{id}/routes lists every route an airline publishes.

AirlineTryNotes
Aegean Airlines (A3)ATH–JTR, or a route from Athens (ATH) to Europe or the Middle EastAirline page
American Airlines (AA)BCN–JFK, or a route through Dallas/Fort Worth (DFW)Airline page
Olympic Air (OA)A Greek domestic route from Athens (ATH)Comes back as Aegean offers. Airline page

A full test

  1. Search: POST /v1/shopping/offers.
  2. Price the offer you pick: POST /v1/offers/price.
  3. Book it as a hold (no payment), then pay it with POST /v1/orders/{orderID}/commit; or book and pay in one call.
  4. Add a seat or a bag, then quote and confirm a change or a cancellation: see Servicing.
  5. Check your webhooks received each event.

Going live

  1. In the dashboard, open Go live: company details, incorporation and tax documents, and your signature on the production agreement.
  2. Norba reviews the request. Your sandbox keeps working throughout.
  3. Once approved, create a production key under API keys and swap it in.
  4. An airline that needs its own agreement answers 403 carrier_agreement_required until it approves; Go live shows its state.
Testing in Sandbox: Test Keys, Card and Routes | Norba Docs