End-to-End Lifecycle

When an agency starts using the API, the system works from three angles: the agency sets up & sells, the Woxx admin configures commercial terms, and the operator manages the reservation in TRMS. Every step below is shown with real screenshots.

1

Agency β€” setup & selling

The agency is set up once; after that it's not repeated clicking, it's an API integration. The panel offers little self-service (keys + live request) β€” the real work is API calls from the agency's own system.

Step 1 β€” Portal & application

Partnership application

The agency opens partner.travapi.com and applies with company, tax and contact details; the application reaches our team.

Portal home
Portal home β€” the agency applies via "Become a Partner".
Application
The agency enters company, tax and contact details and submits the application.
Step 2 β€” Set password

Create your own password after approval

Once approved, the agency receives an email and sets its own password from the link. (The approval step is on the admin side β€” below.)

Set password
The agency sets a new password from the link in the email.
Step 3 β€” Sign in & panel

Sign in, reach the API Access panel

The agency signs in with email + password and reaches the API Access panel. In the panel its only job is managing keys.

Sign in
The agency signs in with its email and the password it set.
Panel
The API Access panel β€” the only place the agency self-manages. No keys yet.
Step 4 β€” Sandbox key

Create a sandbox key

The agency creates a sandbox (test) key with one click. The secret is shown only once; the key appears in the list.

Sandbox key
A sandbox key is created with one click; the secret is shown only once and saved immediately (masked).
Key in list
The new key appears in the list: environment (sandbox), status (active), created date.
Step 5 β€” Live access request

Request live selling

For live selling the agency opens a request via "Request live access"; Woxx approves it and the live key activates.

Live access request
"Request live access" opens a live-key request; it activates after approval.
Step 6 β€” The real usage β€” API

From its own system: token β†’ search β†’ sell

The agency's day-to-day is not in the panel but in its own software: it gets a token with the key, searches hotels/tours/cruises, and books with the chosen rateKey. No real charge in sandbox.

token Β· 1 hoursearch Β· real-timebooking Β· idempotent
API flow
A real run from the agency's own system: get token β†’ 1019 hotels returned β†’ SBX- sandbox booking (no charge).
2

Admin (Woxx) β€” commercial settings

The agency's money is configured here: markup at approval, quota/IP/scope in key management, credit in the current-account limit. The Woxx admin owns all commercial terms.

Internal operations panel The screens below are Woxx's internal admin panel (Turkish UI); the agency never sees them. The English captions explain what happens.
Admin panel

Sign in to the management panel

The Woxx admin signs in to the management panel, from where applications, agencies, keys and reservations are handled.

Admin panel
Operational management panel β€” the hub for applications, agencies, keys and reservations.
Approval + markup

Approve the application, assign the commission margin

The admin sees pending applications under "Acente BaşvurularΔ±" (Agency Applications). On approval the admin enters a markup % β€” the agency + user are created and a set-password email is sent.

Applications
The admin sees pending applications with company info + approve/reject on each row.
Approve dialog
On approval the agency + user are created and the commission margin (markup %) is assigned.
Approved
Approval result β€” the agency is created and the set-password email is sent.
Agency management

The agency record

The approved agency appears in the "Acenteler" (Agencies) list β€” company, tax office, contact and reservation count. Commercial settings such as markup, source market and cruise commission are edited from the agency detail.

Agency record
Agencies list β€” Kaya Travel Agency (Agency #9): company, tax office, contact, reservation count.
Key & quota management

API keys: issue, restrict, monitor

The admin issues keys for the agency and defines scope (hotel/tour/cruise), allowed IPs, daily quota and rate limit. Usage analytics (call count, error rate, latency, endpoint breakdown) are monitored live. Keys can be suspended / revoked; a live key activates after approval.

Key management
Agency API Keys β€” usage analytics (calls/errors/latency), new-key issuance (scope/IP/quota/rate) and key list (suspend/revoke).
3

Operator (TRMS) β€” reservation & account

Every live booking the agency makes via the API lands in TRMS. The operator sees it attributed to the agency, tracks its financials (sale/net/commission) and manages the agency's current account.

Internal operations panel TRMS is Woxx's internal back-office (Turkish UI). Guest names are blurred for privacy. The English captions explain each screen.
Reservation list

The operator sees all reservations

The TRMS reservation list combines source (Travapi / WOXX B2B / Reswio…), supplier, hotel/product, sale amount and status. The Agency filter narrows to a single agency's reservations.

TRMS reservations
Reservations β€” source tabs (Travapi / WOXX B2B / …) plus agency, supplier and status filters (guest names blurred).
Reservation detail

Agency-attributed detail with financials

The detail shows which agency the reservation belongs to (Kaya Travel Agency), the supplier (Woxx), dates, the sale / net / commission breakdown and payment status. From here the operator handles confirm/cancel/refund, voucher and invoicing.

Reservation detail
Reservation detail β€” Source: Travapi, Agency: Kaya Travel Agency, supplier Woxx; sale/net/commission and payment status together.
Agency current account

Current account: credit limit & balance

In card-free (account) selling, each booking posts a debt to the agency's current account. The operator monitors/manages the agency's credit limit, available balance and transactions from here.

Agency account
Agency Current Accounts β€” Kaya: credit limit €5,000, available balance and transactions; account-based sales post debt here.
The chain closes The agency sells via the API β†’ the reservation lands in TRMS attributed to the agency β†’ commission & account are applied automatically β†’ the operator sees and manages it. Three perspectives unite in one system.