{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/tr-TR/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Transfer'e Genel Bakış"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"transfere-genel-bakış","__idx":0},"children":["Transfer'e Genel Bakış"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"entegrasyon-akışı","__idx":1},"children":["Entegrasyon Akışı"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Eksiksiz bir transfer rezervasyonu şu adımlardan oluşur:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Arama"]}," — Alış/bırakış koordinatları, saat ve yolcu sayısını gönderin; fiyatlandırılmış uygun araçları alın."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Teklif Detayı"]}," (isteğe bağlı) — Tek bir teklifi ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchId"]}," ve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," ile yeniden alın."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sipariş Oluşturma"]}," — Yolcu ve fatura bilgileriyle ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pendingPayment"]}," durumunda bir rezervasyon oluşturun."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ödeme"]}," — Oluşturmada dönen ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentRequirement"]}," tutarını kredi limitinizle ödeyin."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Takip"]}," — Ödeme yanıtı siparişi ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reserved"]}," durumu ve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendorReservationId"]}," değeriyle zaten döndürür; sipariş"," ","detayını alış öncesi yeniden kontrol için çekin."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["İptal"]}," (gerekirse) — Önce iptal uygunluğunu ve iade tutarını kontrol edin, sonra iptal edin."]}]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"graph TD\n A[POST /transfer/search] --> B[Teklif seçimi]\n B --> C[POST /transfer/orders]\n C --> D[POST /transfer/orders/orderId/pay]\n D --> E[reserved]\n E --> F[GET /transfer/orders/orderId]\n F --> G{İptal gerekli mi?}\n G -->|Evet| H[POST cancel_eligibility]\n H --> I[POST cancel]\n","diagramHtml":"

Evet

POST /transfer/search

Teklif seçimi

POST /transfer/orders

POST /transfer/orders/orderId/pay

reserved

GET /transfer/orders/orderId

İptal gerekli mi?

POST cancel_eligibility

POST cancel

","diagramHtmlDark":"

Evet

POST /transfer/search

Teklif seçimi

POST /transfer/orders

POST /transfer/orders/orderId/pay

reserved

GET /transfer/orders/orderId

İptal gerekli mi?

POST cancel_eligibility

POST cancel

"},"children":["graph TD\n A[POST /transfer/search] --> B[Teklif seçimi]\n B --> C[POST /transfer/orders]\n C --> D[POST /transfer/orders/orderId/pay]\n D --> E[reserved]\n E --> F[GET /transfer/orders/orderId]\n F --> G{İptal gerekli mi?}\n G -->|Evet| H[POST cancel_eligibility]\n H --> I[POST cancel]\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Her adımın ayrıntısı için ilgili sayfalara bakın:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tr-tr/endpoints/transfer-search"},"children":["Transfer Arama"]}," — arama ve teklif detayı endpoint'leri"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tr-tr/endpoints/transfer-orders"},"children":["Transfer Siparişleri"]}," — sipariş oluşturma, detay ve iptal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tr-tr/endpoints/transfer-payment"},"children":["Transfer Ödemesi"]}," — iki adımlı ödeme"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"kimlikler","__idx":2},"children":["Kimlikler"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Kimlik"},"children":["Kimlik"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Örnek"},"children":["Örnek"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Açıklama"},"children":["Açıklama"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YLPB_0503"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sipariş oluşturmada dönen transfer sipariş kimliği. Tüm transfer endpoint'lerinde bunu kullanın."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendorReservationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["227699"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rezervasyon tamamlandığında atanan tedarikçi rezervasyon referansı. Rezervasyonu tedarikçi veya şoförle eşleştirirken kullanın."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendorReservationId"]},", sipariş ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sipariş-yaşam-döngüsü","__idx":3},"children":["Sipariş Yaşam Döngüsü"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Durum"},"children":["Durum"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Açıklama"},"children":["Açıklama"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pendingPayment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sipariş oluşturuldu ancak henüz ödenmedi. Ödeme gelmezse otomatik olarak sona erer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reserved"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ödeme tamamlandı ve transfer tedarikçi ile onaylandı."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sipariş acente veya tedarikçi tarafından iptal edildi."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sipariş zamanında ödenmedi ve otomatik olarak sona erdi."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rezervasyon tamamlanamadı (örneğin tedarikçi ödeme sonrası reddetti)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"geçerlilik-süreleri","__idx":4},"children":["Geçerlilik Süreleri"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Arama teklifleri"]}," yaklaşık ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["30 dakika"]}," geçerlidir. Süresi dolmuş bir tekliften sipariş oluşturmak ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8003"]}," hatası"," ","döndürür; bu durumda yeni bir arama yapın."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ödenmemiş siparişler"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pendingPayment"]},") oluşturmadan yaklaşık ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["bir saat"]}," sonra sona erer ve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]}," durumuna"," ","geçer."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"önemli-tavsiyeler","__idx":5},"children":["Önemli Tavsiyeler"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"koordinatları-locations-üzerinden-alın-şiddetle-tavsiye-edilir","__idx":6},"children":["Koordinatları ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/locations"]}," üzerinden alın (şiddetle tavsiye edilir)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alış ve bırakış koordinatlarını kendi geocoding çözümünüz yerine ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tr-tr/endpoints/locations"},"children":["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 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["sessizce elenir"]}," ve aynı arama daha az ya da sıfır araç"," ","döndürebilir. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/locations"]}," ilgi noktalarından (havalimanı, otel, semt) gelen koordinatlar tedarikçi bölgeleriyle"," ","güvenilir şekilde eşleşir."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"havalimanı-alışlarında-uçuş-numarası-verin-şiddetle-tavsiye-edilir","__idx":7},"children":["Havalimanı alışlarında uçuş numarası verin (şiddetle tavsiye edilir)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sipariş oluştururken ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flightNumber"]}," (gidiş-dönüşlerde ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"nihai-durumu-sipariş-detayından-doğrulayın","__idx":8},"children":["Nihai durumu sipariş detayından doğrulayın"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ö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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"son-kullanıcının-ip-adresini-iletin","__idx":9},"children":["Son kullanıcının IP adresini iletin"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Entegre acente sistemleri, sipariş ve ödeme isteklerinde son kullanıcının IP adresini ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Forwarded-For"]}," başlığı ile"," ","iletmelidir. Bu bilgi denetim ve güvenlik amaçları için gereklidir."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tutarlar","__idx":10},"children":["Tutarlar"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transfer yanıtlarındaki tüm parasal tutarlar ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["en küçük para biriminde"]}," (TRY için kuruş) ifade edilir:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{\"amount\": 145200, \"currency\": \"TRY\"}"]}," 1.452,00 TL anlamına gelir."]}]},"headings":[{"value":"Transfer'e Genel Bakış","id":"transfere-genel-bakış","depth":1},{"value":"Entegrasyon Akışı","id":"entegrasyon-akışı","depth":2},{"value":"Kimlikler","id":"kimlikler","depth":2},{"value":"Sipariş Yaşam Döngüsü","id":"sipariş-yaşam-döngüsü","depth":2},{"value":"Geçerlilik Süreleri","id":"geçerlilik-süreleri","depth":2},{"value":"Önemli Tavsiyeler","id":"önemli-tavsiyeler","depth":2},{"value":"Koordinatları /locations üzerinden alın (şiddetle tavsiye edilir)","id":"koordinatları-locations-üzerinden-alın-şiddetle-tavsiye-edilir","depth":3},{"value":"Havalimanı alışlarında uçuş numarası verin (şiddetle tavsiye edilir)","id":"havalimanı-alışlarında-uçuş-numarası-verin-şiddetle-tavsiye-edilir","depth":3},{"value":"Nihai durumu sipariş detayından doğrulayın","id":"nihai-durumu-sipariş-detayından-doğrulayın","depth":3},{"value":"Son kullanıcının IP adresini iletin","id":"son-kullanıcının-ip-adresini-iletin","depth":3},{"value":"Tutarlar","id":"tutarlar","depth":2}],"frontmatter":{"seo":{"title":"Transfer'e Genel Bakış"}},"lastModified":"2026-10-01T06:30:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/tr-tr/endpoints/transfer-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}