Brave Partner Gateway

Brave Booking’s partner gateway lets every Brave company (incoming agency, hotel chain, hotel) sell its own hotel stock to its B2B partners — agencies, OTAs, wholesalers — through a single API, without Brave becoming a wholesaler.

Three gateways, one inventory

Each partner reaches the same catalogue and the same bookings through the gateway that matches its system:

  • Brave gateway — clean REST, in JSON and XML (chosen by the Accept header), authenticated with X-Api-Key + X-Signature. This is the reference, documented page by page.
  • OS-Travel compatible gateway (Octasoft) — JSON, POST {base}/api/hotel/<Method>, Credential { Login, Password } in every request, always HTTP 200 with ErrorMessage { Code, Description } on errors.
  • Cyberesa compatible gateway — XML, form-url-encoded POST with a strRQ field, <Credential><Login/><Password/></Credential> as first child, d/m/Y dates, Available = 'Disponible'.

Key concepts

  • {code} — the Brave company code (e.g. 1000) present in every Brave gateway URL.
  • rateKey — signed offer key returned by search, to be replayed as-is in checkrate then in the booking.
  • clientReference — your booking reference, mandatory and unique: a duplicate returns the same booking (idempotency).
  • JSON / XML — the Brave gateway format is chosen by the Accept header (application/json by default, application/xml for XML).

Guides

Access & API keys

Get your test and live API keys, allowed IPs and enabled gateways.

Read more

Request signing

Compute the sha256 signature (key + secret + timestamp) that authenticates every call.

Read more

Errors

HTTP codes, OS-Travel and Cyberesa business errors, and how to handle them.

Read more

Rate limits

Per-second and per-day quotas, 429 responses and the Retry-After header.

Read more

Gateways & resources

Porte Brave (REST)

Full reference of the Brave REST API, in JSON and XML: search, rates, bookings.

OS-Travel (Octasoft)

OS-Travel compatible gateway: same methods and JSON messages as the Octasoft API.

Cyberesa

Cyberesa compatible gateway: same XML messages (strRQ), d/m/Y dates and Available=Disponible.

Collection Postman

Ready-to-import collection with requests for all three gateways and environment variables.

Was this page helpful?