API + Widget + Webhooks
Add transfers to your platform
Integrate pre-booked ground transport into your website or app with our REST API, embeddable booking widget and webhooks. Commission terms are agreed per partner.
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": "Ada Example",
"contact_phone": "+90 555 000 00 00",
"passenger_count": 2,
"payment_method": "cash",
"legs": [{
"pickup": {
"lat": 41.2753, "lng": 28.7519,
"address": "Istanbul Airport (IST)"
},
"dropoff": {
"lat": 41.0054, "lng": 28.9768,
"address": "Sultanahmet"
},
"pickup_at": "2026-04-15T14:00:00Z",
"vehicle_class": "comfort"
}]
}'{ "id": "bk_a1b2c3", "status": "confirmed",
"fare": { "total_cents": 150000, "currency": "TRY" } }Three ways to integrate
Choose the integration depth that fits your engineering capacity and business needs.
REST API
Full control, maximum flexibility
Endpoints covering the booking lifecycle: fare estimation, booking creation, ride status and settlement reporting. OpenAPI 3.0 spec available.
- Fare estimation with vehicle class breakdown
- Multi-leg booking creation
- Real-time ride status & driver GPS
- Cash to the driver on partner bookings
- Settlement reports & commission tracking
- Geofence & zone pricing queries
Booking Widget
Copy-paste embed, zero backend work
Drop a single iframe tag into your page. The widget handles location search, fare display, vehicle selection, payment selection, 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
- Cash to the driver on bookings from your embed
- Auto-populates partner API key
- Event callbacks for conversion tracking
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
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, so your customers see the transfer option while they plan the trip.
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.
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.
Commercial terms are in the partner agreement
Commission, payment term and payment method are written into the partner agreement after your request is reviewed. We publish no rate, volume tier or package on this page.
A conversation first
Your request is reviewed. Access and commercial terms are agreed after that conversation, in a contract.
Commission by contract
The commission rate and how it is calculated are written in your partner agreement; it is calculated on a completed ride.
Amounts in Turkish lira
Amounts on the platform are shown and calculated in Turkish lira (TRY). Card payment is not open yet; on rides through a partner channel the passenger may pay the driver in cash.
Commission and payment terms are set in your partner agreement. This page makes no rate, income or payment promise.
Technical specifications
The basics you need to plan your integration.
API Protocol
REST (JSON)
Auth
Bearer Token (API Key)
Spec
OpenAPI 3.0
Rate Limit
1,000 req/min
Webhook Retry
Exponential (72h)
Environments
Sandbox + Production
Get started in 4 steps
Create Account
Sign up at partners.youtourer.com. Verify your business email and company details.
Get API Keys
API keys are issued after we review your partner application. 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. You earn commission on each completed ride under your partner contract.
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. Settlement summaries and invoice downloads.
Security Center
API key rotation, webhook secret management, and access logs. OAuth 2.0 authentication with role-based permissions.
Frequently Asked Questions
How long does it take to go live?
Your partner account is reviewed first. Once it is approved, the widget is a copy-paste iframe embed; an API integration takes as long as your booking flow requires. We provide a sandbox environment for testing before going live.
How does commission work?
The commission rate, how it is calculated and the settlement terms are set in your partner agreement. We publish no rate on this page.
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 handling.
What payment methods are supported?
Bookings made through your widget embed or the partner API can be paid in cash to the driver; bookings made on youtourer.com itself are prepaid by card. Online card payment is not live yet and appears only when the payment provider flow is ready for a booking.
Which currency is used?
Amounts on the platform are calculated and shown in Turkish lira (TRY); settlement is in TRY too. Other currencies are not offered today.
PARTNER REVIEW
Talk to us about a partnership
Tell us who you are and how you would like to work with Youtourer. The partnerships team reads every request and replies by email. Do not send passenger information or identity documents here.
This is a request to talk. It does not create an account, API access, a plan or an offer. Access and commercial terms are agreed separately, after a review.
Running a fleet? Send an operator review request instead.
This form is not open yet
We are not taking partner requests through this form right now. To talk to the partnerships team, write to partners@youtourer.com
Add transfers to your platform
Apply for a partner account. Once your account is approved you receive your API keys and copy-paste the widget into your site.
Partnership requests: [email protected]