Environments
HAPI v3 has two environments, test and live. You choose which one you are hitting by the credential you authenticate with, not by a different host.
One base, two credentials
Every request goes to https://api.hermeseus.com/v3/HAPI. Your account has separate credentials per environment:
| Environment | client_id prefix | What it does |
|---|---|---|
| Test (sandbox) | cid_test_ | Search is real. Bookings hold against a sandbox wallet and never move real funds or issue with a supplier. |
| Live | cid_live_ | Operates against your real office wallet. |
The token you receive echoes its environment:
{
"access_token": "hat_test_…",
"environment": "test"
}Sandbox behaviour
In test, the full flow works end to end: search, revalidate, create an order, and read it back. The amount is held on a sandbox wallet so you can build and test the whole integration without spending. Move to a live credential when you are ready to transact for real.
Keep them apart.
A test token cannot see live orders, and a live token cannot see sandbox orders. Use the matching credential for the data you expect.
Was this page helpful?