Skip to main content
Organisation accounts, API keys, wallets and billing for companies that book travel through GTW. Hotel booking and gift cards plug into this — they charge through the billing service described below. The two are separate deployments with separate databases. Accounts, keys and balances do not carry over; a key used against the wrong one is refused with wrong_environment_key.

​
Conventions

  • Every response is { "environment": "sandbox" | "production", "data": … }.
  • Errors are { "environment", "error": { "code", "message", "details"? } }. code is stable; switch on it, not on message.
  • Money is always a string in major units ("1250.50"), never a float. Wallet currencies: NGN, USD.
  • Writes that move money take an Idempotency-Key header. Retrying with the same key returns the original result (replayed: true); reusing it for a different request is 409 reference_conflict.

​
Where to start

  1. Sign in and create an organisation, then create an API key.
  2. Fund a wallet. In sandbox, a simulated deposit is one call.
  3. Book a hotel or buy a gift card.