16 — OTA / Partner Portal Specification
Surface: Web app — B2B portal for OTA partners, corporate accounts, and travel agents URL:
https://partners.melmastoon.comPhase: P2 / R3 Shell: Operator shell (partner-density variant) Competitive reference: Booking.com Extranet, Expedia Partner Central, Cloudbeds partner APIs, SiteMinder Channel Manager
1. Overview
The OTA / partner portal enables third-party distribution:
- OTA / channel partners: Retrieve live availability and rates via API or portal; manage allotments; reconcile bookings.
- Corporate accounts: Book rooms for employees at negotiated rates; manage travel policy and approval flows.
- Travel agents: Access contracted rates; create bookings on behalf of clients; earn commission.
Differentiator: Self-serve onboarding without requiring a Ghasi sales call. Partners can sign up, connect properties, and start distributing within a day.
2. Partner types and permissions
| Partner type | What they see | Can create bookings | Can manage allotments |
|---|---|---|---|
| OTA channel partner | Availability + rates (all connected properties) | Via API | Yes |
| Corporate account | Availability + contracted rates for approved hotels | Yes (direct booking) | No |
| Travel agent | Availability + agent rates | Yes (on behalf of client) | No |
3. Route tree
/partners
/dashboard ← Partner home (connected properties, recent bookings, alerts)
/properties ← Browse and connect to properties
/[property_id] ← Property availability calendar + rate plans
/bookings ← Booking list (create, view, cancel)
/[booking_id] ← Booking detail + modification
/allotments ← Allotment management (OTA partners only)
/rates ← Contracted rate overview
/billing ← Commission statement, invoice
/api-access ← API key management, quota, webhook config
/settings ← Partner profile, contact, notification preferences
/onboarding ← Self-serve onboarding wizard (new partners)
4. Key screens
4.1 Onboarding wizard
- Partner type selection (OTA / Corporate / Travel agent)
- Company details (name, registration, country, contact)
- Accepted: platform terms + commission structure
- Property connection: search Melmastoon properties + request connection
- API credentials (for OTA channels): auto-generated API key + webhook URL
- Test connection: one test booking in sandbox
- Go-live confirmation
4.2 Availability calendar (OTA / TA)
Property: Hotel Kabul Palace
Month: May 2026
Mon Tue Wed Thu Fri Sat Sun
1–7 8/10 5/10 6/10 4/10 2/10 0/10 1/10
$95 $95 $95 $95 $120 SOLD $120
[Rate plan: Standard ▾] [Room type: Double ▾]
Click a date: rate detail flyout (all rate plans, cancellation policy, inclusions, allotment remaining).
4.3 Allotment management (OTA)
- Monthly grid: allotment used / total per room type
- "Request allotment increase" → submitted to tenant for approval
- Release unsold allotment: bulk release or per-date
4.4 Booking creation (TA / Corporate)
Step-by-step:
- Property + dates + room type
- Rate plan (contracted rates highlighted)
- Guest details (name, email, phone — client's details, not the agent's)
- Payment: credit card or "invoice to account"
- Confirmation + booking reference
4.5 API access (OTA)
- Current API key (masked; "Reveal" with MFA confirmation)
- Rotate key
- Webhook URL configuration
- Rate limits: current usage vs quota (chart)
- Logs: last 100 API calls (endpoint, status, latency)
5. Commission and billing
- Commission earned per booking shown in real-time
- Monthly statement: bookings, gross value, commission rate, commission earned, deductions
- Invoice download (PDF; tax-compliant format per partner country)
- Payout: manual bank transfer (Phase 2) → Stripe Connect (Phase 3)
6. Security requirements
- Partners authenticate with email/password + TOTP (no SSO — partners are external)
- API keys are scoped per property (partner cannot access other tenants' data)
- Corporate booking flow requires additional approval if above travel policy threshold
- Commission data is partner-confidential (not visible to tenants in their portal, only as aggregate)