Skip to main content
API + Widget + Webhooks

Add transfers to your platform

Integrate premium ground transport into your website or app. REST API with 150+ endpoints, embeddable booking widget, and real-time webhooks. Earn commission on every booking.

150+

API endpoints

< 1h

Widget setup

99.9%

Uptime SLA

Create a booking
curl -X POST https://api.youtourer.com/api/v1/transport/bookings \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Tenant-ID: YOUR_TENANT_ID" \
  -d '{
    "channel": "partner",
    "contact_name": "John Doe",
    "contact_phone": "+44 7700 900000",
    "passenger_count": 2,
    "payment_method": "card",
    "legs": [{
      "pickup": {
        "lat": 36.8969, "lng": 30.7133,
        "address": "Antalya Airport (AYT)"
      },
      "dropoff": {
        "lat": 36.8529, "lng": 30.7313,
        "address": "Kaleiçi Old Town"
      },
      "pickup_at": "2026-04-15T14:00:00Z",
      "vehicle_class": "comfort"
    }]
  }'
201 Created
{ "id": "bk_a1b2c3", "status": "pending_payment",
  "fare": { "total_cents": 3500, "currency": "EUR" },
  "payment_intent": { "client_secret": "pi_..." } }

Three ways to integrate

Choose the integration depth that fits your engineering capacity and business needs.

REST API

Full control, maximum flexibility

150+ endpoints covering the complete booking lifecycle: fare estimation, booking creation, ride tracking, payment management, and settlement reporting. OpenAPI 3.0 spec available.

  • Fare estimation with vehicle class breakdown
  • Multi-leg booking creation
  • Real-time ride status & driver GPS
  • Payment intent creation (Stripe + iyzico)
  • Settlement reports & commission tracking
  • Geofence & zone pricing queries
View API Docs

Booking Widget

Embed in 5 minutes, zero backend work

Drop a single iframe tag into your page. The widget handles location search, fare display, vehicle selection, payment, and confirmation. Fully customizable colors to match your brand.

  • Single iframe embed — one line of HTML
  • Custom colors, logo, and language
  • Mobile-responsive by default
  • Stripe-powered secure payment
  • Auto-populates partner API key
  • Event callbacks for conversion tracking
Widget Builder

Webhooks

Real-time events, zero polling

Subscribe to booking lifecycle events and receive HTTPS POST callbacks in real-time. HMAC-signed payloads ensure authenticity. Automatic retry with exponential backoff on failure.

  • booking.created, booking.confirmed
  • ride.assigned, ride.started, ride.completed
  • payment.captured, settlement.completed
  • HMAC-SHA256 signature verification
  • Configurable retry policy (up to 72h)
  • Event log with replay capability
Configure Webhooks

Built for your business type

Whether you're an OTA, hotel, or travel agency — we have the right integration for your workflow.

Online Travel Agencies

Increase AOV with transfer add-ons

Embed transfers alongside flights and hotel bookings. Your customers see the transfer option at the perfect moment — during trip planning. Average booking value increases 15-25% when transfers are offered as an add-on.

Examples: Tour operators, booking platforms, travel aggregators, comparison sites
Best integration:REST API + Webhooks

+15-25%

AOV Increase

8-12%

Conversion

< 1 day

Integration

Hotels & Resorts

Guest experience from landing to lobby

Offer airport pickup to every guest at booking confirmation. Concierge-ready with branded booking links that auto-fill property address as drop-off. Pre-arrival emails with driver details and tracking links.

Examples: Boutique hotels, all-inclusive resorts, serviced apartments, holiday villas
Best integration:Booking Widget (branded)

+30%

Guest Satisfaction

€35

Avg Revenue/Guest

Widget

Integration

Travel Agencies & DMCs

Complete ground transport for packages

Add licensed, tracked ground transport to your travel packages. API-level integration for bulk booking creation, group transfers, and multi-leg itineraries. Settlement reports sync with your back-office accounting.

Examples: DMCs, corporate travel, luxury travel planners, MICE agencies
Best integration:REST API + Settlement Reports

+20%

Package Upsell

60%

Ops Savings

API

Integration

Revenue model

Earn commission on every completed booking. Higher volume = higher commission rate. No setup fees, no monthly minimums.

Starter

0-100/mo

8%

commission per booking

  • API access
  • Widget embed
  • Basic webhooks
  • Email support

Growth

100-1,000/mo

10%

commission per booking

  • Everything in Starter
  • Custom widget branding
  • Priority support
  • Settlement reports

Enterprise

1,000+/mo

12%

commission per booking

  • Everything in Growth
  • Dedicated account manager
  • SLA guarantee
  • Custom integration support

Commission is calculated on net fare after payment processing fees. Settled weekly via bank transfer.

Technical specifications

Enterprise-grade infrastructure built for reliability.

API Protocol

REST (JSON)

Auth

Bearer Token (API Key)

Spec

OpenAPI 3.0

Rate Limit

1,000 req/min

Uptime SLA

99.9%

Webhook Retry

Exponential (72h)

Environments

Sandbox + Production

Response Time

< 200ms (p95)

Get started in 4 steps

Create Account

Sign up at partners.youtourer.com. Verify your business email and company details.

Get API Keys

Receive sandbox and production API keys instantly. Access the full OpenAPI documentation.

Integrate & Test

Build your integration against the sandbox. Test the full booking flow with simulated drivers.

Go Live

Switch to production keys. Bookings start generating commission immediately.

Your partner dashboard

Everything you need to manage your integration, track performance, and optimize revenue.

Analytics Dashboard

Real-time booking counts, conversion rates, revenue by date range and vehicle class. Export to CSV for reporting.

API Explorer

Interactive API documentation with try-it-now functionality. Test every endpoint directly from your browser.

Widget Builder

Visual configurator for your booking widget. Adjust colors, defaults, and preview the result in real-time. Copy embed code with one click.

Webhook Manager

Configure endpoints, select event types, view delivery logs, and replay failed deliveries. Test webhooks with sample payloads.

Settlement Reports

Detailed commission breakdown per booking. Weekly settlement summaries, invoice downloads, and bank transfer tracking.

Security Center

API key rotation, webhook secret management, and access logs. OAuth 2.0 authentication with role-based permissions.

We integrated the booking widget into our hotel's confirmation page in under an hour. Our guests now book their airport transfer at the same time as their room. It's added €12 average revenue per booking and our reviews mention the 'seamless transfer experience' regularly.

Boutique Hotel Operations Manager

Belek, Antalya · Widget integration · 200+ bookings/month

Frequently asked questions

How long does it take to go live?

Widget integration: under 1 hour (copy-paste an iframe). API integration: typically 1-3 days depending on your booking flow complexity. We provide a sandbox environment for testing before going live.

How does commission work?

You earn a percentage of every completed booking made through your integration. Commission is calculated on the net fare (after payment processing fees). Settled weekly to your bank account with detailed reports.

Can I white-label the booking experience?

Yes. The widget supports custom colors, logo, and language. Your customers see your brand, not ours. For API integrations, you build the entire UI — our API is the invisible backend.

Is there a sandbox for testing?

Yes. Every partner account includes a sandbox environment with test API keys. All endpoints work identically to production but with simulated driver dispatch and payment processing.

What payment methods are supported?

Credit/debit cards via Stripe (global) and iyzico (Turkey). Cash payment option available. The widget handles the full payment flow — for API partners, we provide payment intent endpoints.

Do you support multi-currency?

Fares are displayed in EUR by default. Local currency display (TRY, GBP, USD, RUB) is available via the API and configurable in the widget. Settlement is in EUR.

Start earning from transfers today

Create your partner account, get API keys, and start integrating. Widget setup under 1 hour. No setup fees, no monthly minimums.

Enterprise inquiries: [email protected]