Transfer API'si, acentelerin özel transfer hizmetlerini (havalimanı karşılama, noktadan noktaya yolculuk) araç kiralama ile aynı Yolcu360 Agency API'si üzerinden aramasına, rezerve etmesine, ödemesine ve yönetmesine olanak tanır. Kimlik doğrulama, hata formatı ve genel kurallar API'nin geri kalanıyla ortaktır.
Eksiksiz bir transfer rezervasyonu şu adımlardan oluşur:
- Arama — Alış/bırakış koordinatları, saat ve yolcu sayısını gönderin; fiyatlandırılmış uygun araçları alın.
- Teklif Detayı (isteğe bağlı) — Tek bir teklifi
searchIdvecodeile yeniden alın. - Sipariş Oluşturma — Yolcu ve fatura bilgileriyle
pendingPaymentdurumunda bir rezervasyon oluşturun. - Ödeme — Oluşturmada dönen
paymentRequirementtutarını kredi limitinizle ödeyin. - Takip — Ödeme yanıtı siparişi
reserveddurumu vevendorReservationIddeğeriyle zaten döndürür; sipariş detayını alış öncesi yeniden kontrol için çekin. - İptal (gerekirse) — Önce iptal uygunluğunu ve iade tutarını kontrol edin, sonra iptal edin.
Her adımın ayrıntısı için ilgili sayfalara bakın:
- Transfer Arama — arama ve teklif detayı endpoint'leri
- Transfer Siparişleri — sipariş oluşturma, detay ve iptal
- Transfer Ödemesi — iki adımlı ödeme
| Kimlik | Örnek | Açıklama |
|---|---|---|
orderId | YLPB_0503 | Sipariş oluşturmada dönen transfer sipariş kimliği. Tüm transfer endpoint'lerinde bunu kullanın. |
vendorReservationId | 227699 | Rezervasyon tamamlandığında atanan tedarikçi rezervasyon referansı. Rezervasyonu tedarikçi veya şoförle eşleştirirken kullanın. |
vendorReservationId, sipariş pendingPayment durumundayken yanıtta yer almaz; başarılı ödeme ve rezervasyon sonrası ödeme yanıtında ve sipariş detayında görünür ve sonrasında, iptal dahil, siparişte kalır.
| Durum | Açıklama |
|---|---|
pendingPayment | Sipariş oluşturuldu ancak henüz ödenmedi. Ödeme gelmezse otomatik olarak sona erer. |
reserved | Ödeme tamamlandı ve transfer tedarikçi ile onaylandı. |
canceled | Sipariş acente veya tedarikçi tarafından iptal edildi. |
expired | Sipariş zamanında ödenmedi ve otomatik olarak sona erdi. |
failed | Rezervasyon tamamlanamadı (örneğin tedarikçi ödeme sonrası reddetti). |
- Arama teklifleri yaklaşık 30 dakika geçerlidir. Süresi dolmuş bir tekliften sipariş oluşturmak
8003hatası döndürür; bu durumda yeni bir arama yapın. - Ödenmemiş siparişler (
pendingPayment) oluşturmadan yaklaşık bir saat sonra sona erer veexpireddurumuna geçer.
Alış ve bırakış koordinatlarını kendi geocoding çözümünüz yerine Lokasyonlar endpoint'lerinden (yer arama + yer detayı) alın. Transfer tedarikçileri koordinatları kendi hizmet bölgelerine eşler; bir tedarikçinin bölgesinin biraz dışına düşen ham koordinatlar sonuçlardan sessizce elenir ve aynı arama daha az ya da sıfır araç döndürebilir. /locations ilgi noktalarından (havalimanı, otel, semt) gelen koordinatlar tedarikçi bölgeleriyle güvenilir şekilde eşleşir.
Sipariş oluştururken flightNumber (gidiş-dönüşlerde returnFlightNumber) alanını gönderin. Tedarikçiler bu bilgiyle uçağın gerçek varış saatini takip eder ve rötarlarda alış saatini ayarlar. Verilmezse sürücü yalnızca planlanan saatte bekler.
Ödeme yanıtı tahsilat sonrası geri okunan siparişin kendisidir; gerçek rezervasyon sonucunu zaten bildirir. Onaylanmış bir rezervasyon sonradan da düşebilir (örneğin tedarikçi tarafı iptal), bu nedenle alış saatinden önce durumu yeniden kontrol etmeniz önerilir.
Entegre acente sistemleri, sipariş ve ödeme isteklerinde son kullanıcının IP adresini X-Forwarded-For başlığı ile iletmelidir. Bu bilgi denetim ve güvenlik amaçları için gereklidir.
Transfer yanıtlarındaki tüm parasal tutarlar en küçük para biriminde (TRY için kuruş) ifade edilir: {"amount": 145200, "currency": "TRY"} 1.452,00 TL anlamına gelir.