Rezervasyon aşamaları

Rezervasyonun bir rezervasyon durumu vardır; her kalemin (transfer, saatlik hizmet ya da havalimanı hizmeti) de kendi kalem durumu vardır.

Rezervasyon durumu

`status`	Anlamı	Ne yapmalısınız
`confirmed`	Hizmeti garanti ediyoruz.	Yolcuya onaylı olarak gösterin.
`on_request`	Müsaitliği ya da fiyatı kontrol ediyoruz (kısa süre kala, özel istek, düzenli hizmet alanı dışı ya da hesabınızın kredi limiti aşılacaksa).	"Onay bekleniyor" olarak gösterin. Genellikle birkaç saat içinde onaylar ya da alternatif öneririz; bildirim alırsınız.
`offered`	Talep üzerine rezervasyon için fiyat ya da araç önerdik. `offer` nesnesinde notumuz ve yeni toplam yer alır; kalem fiyatları teklif fiyatlarıdır.	Yolcuya sorun, ardından `POST /bookings/{reference}/offer/accept` ya da `/offer/decline`. Onaylı saymayın.
`pending_payment`	Kartla ödeyen hesaplar: `payment_url` üzerinden ödeme bekleniyor.	Yolcuyu `payment_url` adresine yönlendirin.
`cancelled`	Sizin ya da bizim tarafımızdan iptal edildi.	İptal ücreti için `total` alanına bakın.

Talep rezervasyonlarında teklif

Rezervasyonu anında onaylayamadığımızda on_request olur. Ardından ya onaylarız (confirmed) ya da başka fiyat / araç öneririz (offered); iki durumda da booking.updated gelir. Son yolcuya mı satıyorsunuz? instant_only gönderin (ya da hesabınızı yalnız anında onaya aldırın), bu durumlar hiç oluşmaz: bkz. Fiyat ve rezervasyon.

"status": "offered",
"offer": { "offered_at": "2026-11-01T10:15:00+00:00", "note": "Minivan yok, aynı fiyata Vito", "total": 120.0, "currency": "EUR", "accepted_at": null }

POST /bookings/{reference}/offer/accept → rezervasyon confirmed olur. Kartla ödeyen hesaplara payment_url döner; ödeme gelince onaylanır (bu arada offer.accepted_at dolu).
POST /bookings/{reference}/offer/decline (isteğe bağlı {"reason": "…"}) → rezervasyon ücretsiz iptal edilir.
Açık teklif yoksa ikisi de 409 not_offered döner. Test ortamında durumu POST /test/bookings/{reference}/simulate ile {"event": "on_request"}, ardından {"event": "offered"} göndererek oluşturun.

Kalem durumu

`status`	Anlamı
`scheduled`	Planlandı; şoför henüz atanmadı.
`driver_assigned`	Şoför atandı: `driver.name`, `driver.phone` ve `driver.vehicle_plate` dolu.
`on_route`	Şoför yolda ya da alış noktasında bekliyor.
`completed`	Hizmet tamamlandı.
`no_show`	Yolcu gelmedi; hizmet ücretlendirilir.
`cancelled`	Kalem iptal edildi. Geç iptal edildiyse `cancellation_fee` ücreti gösterir.

Şoför bilgisi genellikle bir gün önce, en geç alıştan birkaç saat önce atanır.

Değişiklikleri takip etme

Rezervasyonları iki yolla takip edebilirsiniz — ikisini birlikte kullanın:

Bildirimler (önerilir): müşterinizin görebileceği her değişiklikten (durum, şoför, saat, fiyat) sonraki birkaç dakika içinde booking.updated ya da booking.cancelled göndeririz. Bkz. Bildirimler.
Sorgulama: GET /bookings/{reference} güncel hali döner. Sorgulama yapacaksanız rezervasyon başına en sık 15 dakikada bir ve sadece önümüzdeki 48 saatteki rezervasyonlar için yapın.

Saatler

pickup_at, alış yerinin yerel saatidir ve saat farkı içermez, örneğin 2026-11-20T14:30; timezone IANA saat dilimini verir (Europe/Istanbul). Saatleri yolcuya çevirmeden, olduğu gibi gösterin.

Uçuş rötarları

flight_number verilen havalimanı alışlarında şoför uçuşu takip eder ve gerçek iniş saatine göre bekler. Ücretsiz bekleme süresi araç tipine göre GET /vehicle-types cevabındaki free_waiting_minutes alanındadır (inişten itibaren).

← Havalimanı hizmetleri Bildirimler (webhook) →