{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/tr-TR/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Transfer Ödemesi"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"transfer-ödemesi","__idx":0},"children":["Transfer Ödemesi"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transfer ödemeleri iki adımlı bir modeldir: sipariş oluşturma bir ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentRequirement"]}," döndürür, ödeme endpoint'i tam"," ","olarak bu tutarı tahsil eder. Transfer siparişleri acentenin kredi limitiyle ödenir."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"i̇ki-adımlı-ödeme-modeli","__idx":1},"children":["İki Adımlı Ödeme Modeli"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /transfer/orders"]}," siparişi oluşturur ve tahsil edilecek tam tutar olan ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentRequirement"]}," değerini döndürür."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /transfer/orders/{orderId}/pay"]}," bu tutarı tahsil eder. Başarılı bir ödeme, tedarikçi rezervasyonunu ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["eşzamanlı"]}," ","tetikler ve yanıt siparişin güncel halidir: rezervasyon tamamlandığında ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reserved"]},", tedarikçi reddettiyse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Zaten ödenmiş bir siparişi ödemek ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8009"]}," hatası döndürür. Çifte tahsilat riski yoktur: aynı sipariş üzerindeki eşzamanlı"," ","ödeme denemeleri sıralanır ve ikinci deneme ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8009"]}," (ilki hâlâ işleniyorsa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8008"]},") ile başarısız olur."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sipariş-ödemesi","__idx":2},"children":["Sipariş Ödemesi"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint","__idx":3},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /transfer/orders/{orderId}/pay\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"kimlik-doğrulama","__idx":4},"children":["Kimlik Doğrulama"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Bu endpoint kimlik doğrulama gerektirir. Authorization başlığında JWT erişim jetonunuzu ekleyin:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer ERIŞIM_JETONUNUZ\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"son-kullanıcı-ip-adresi","__idx":5},"children":["Son Kullanıcı IP Adresi"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Entegre acente sistemleri, 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":3,"id":"yol-parametreleri","__idx":6},"children":["Yol Parametreleri"]},{"$$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":"Parametre"},"children":["Parametre"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tür"},"children":["Tür"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Gerekli"},"children":["Gerekli"]},{"$$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":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Evet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transfer sipariş kimliği"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"i̇stek-gövdesi","__idx":7},"children":["İstek Gövdesi"]},{"$$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":"Alan"},"children":["Alan"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tür"},"children":["Tür"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Gerekli"},"children":["Gerekli"]},{"$$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":["paymentType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Evet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ödeme yöntemi, her zaman ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"örnek-i̇stek","__idx":8},"children":["Örnek İstek"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.pro.yolcu360.com/api/v1/transfer/orders/YLPB_0503/pay \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer ERIŞIM_JETONUNUZ\" \\\n  -H \"X-Forwarded-For: 203.0.113.195\" \\\n  -d '{\n    \"paymentType\": \"limit\"\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"yanıt","__idx":9},"children":["Yanıt"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yanıt, tahsilat sonrası geri okunan güncel siparişin kendisidir. Sipariş oluşturma ve sipariş detayı yanıtlarıyla aynı"," ","şekildedir; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product"]}," aşağıda kısaltılmıştır, tam yapı için ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tr-tr/endpoints/transfer-orders"},"children":["Transfer Siparişleri"]}," sayfasına bakın."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"ödeme-tamamlandı-200-ok","__idx":10},"children":["Ödeme Tamamlandı (200 OK)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rezervasyon onaylanmıştır ve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendorReservationId"]}," hazırdır:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"orderId\": \"YLPB_0503\",\n  \"status\": \"reserved\",\n  \"vendorReservationId\": \"227699\",\n  \"flightNumber\": \"TK2021\",\n  \"product\": {\n    \"code\": \"9972a93a-707e-403e-928e-cbb68a65584f\",\n    \"appointment\": {\n      \"pickup\": {\"lat\": 41.276146, \"lon\": 28.728735, \"name\": \"Istanbul Airport (IST)\"},\n      \"dropoff\": {\"lat\": 41.037003, \"lon\": 28.985092, \"name\": \"Taksim Square\"},\n      \"pickupTime\": \"2027-06-15T10:00:00+03:00\",\n      \"passengerCount\": 2\n    },\n    \"vehicle\": {\"name\": \"Minivan\", \"seatCount\": 6, \"baggageCount\": 6},\n    \"pricing\": {\"currency\": \"TRY\", \"total\": {\"amount\": 145200, \"currency\": \"TRY\"}},\n    \"cancellationPolicies\": [\n      {\"type\": \"freeCancel\", \"until\": \"2027-06-15T09:00:00+03:00\", \"description\": \"You can cancel your transfer free of charge up to 1 hour before departure.\"}\n    ]\n  },\n  \"passengers\": [\n    {\"primary\": true, \"firstName\": \"John\", \"lastName\": \"Doe\", \"gender\": \"M\", \"birthDate\": \"1990-01-15\", \"nationality\": \"US\", \"passportNo\": \"AB1234567\", \"email\": \"john.doe@example.com\", \"phone\": \"+905551234567\"},\n    {\"primary\": false, \"firstName\": \"Jane\", \"lastName\": \"Doe\", \"identityNumber\": \"11111111110\"}\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tahsilat geçtiği halde tedarikçi rezervasyonu reddetmişse aynı yanıt ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status: \"failed\""]}," ile döner (aşağıdaki uç"," ","durumlara bakın)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"yanıt-alanları","__idx":11},"children":["Yanıt Alanları"]},{"$$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":"Alan"},"children":["Alan"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tür"},"children":["Tür"]},{"$$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":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transfer sipariş kimliği"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sipariş yaşam döngüsü durumu: ödeme tamamlandığında ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reserved"]},", tedarikçi rezervasyonu reddettiyse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]}]},{"$$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":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tedarikçi rezervasyon referansı. Sipariş ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reserved"]}," olduktan sonra döner"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flightNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sipariş oluşturmada verilen uçuş numarası"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returnFlightNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sipariş oluşturmada verilen dönüş uçuş numarası (gidiş-dönüşlerde)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rezerve edilen teklif, arama yanıtındaki ürünle aynı yapıda"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passengers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sipariş oluşturmada verilen yolcu bilgileri"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"uç-durumlar","__idx":12},"children":["Uç Durumlar"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sipariş-zaten-ödenmiş-8009","__idx":13},"children":["Sipariş zaten ödenmiş (8009)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Zaten ödenmiş bir siparişi ödemek hiçbir tahsilat yapılmadan başarısız olur:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 8009,\n  \"description\": \"Transfer order is already paid\",\n  \"details\": {\n    \"orderId\": \"YLPB_0503\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8009"]}," hatasını \"sipariş durumunu kontrol et\" olarak yorumlayın: sipariş büyük olasılıkla zaten ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reserved"]}," durumundadır."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"eşzamanlı-ödeme-denemeleri-8008","__idx":14},"children":["Eşzamanlı ödeme denemeleri (8008)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["İlk ödeme hâlâ işlenirken ikinci bir deneme gelirse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8009"]}," yerine ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8008"]}," (ödeme başarısız) dönebilir. Her iki durumda da"," ","çifte tahsilat olmaz. Yeniden deneme politikası: önce sipariş durumunu kontrol edin; yalnızca sipariş hâlâ"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pendingPayment"]}," durumundaysa ödemeyi yeniden deneyin."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ödeme-başarılı-ama-rezervasyon-başarısız-8010","__idx":15},"children":["Ödeme başarılı ama rezervasyon başarısız (8010)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nadir durumlarda tahsilat başarılı olur ancak tedarikçi rezervasyonu başarısız olur. Ödeme ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8010"]}," hatası"," ","(",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payment succeeded but the reservation could not be completed"]},") ya da ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," değeri ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}," olan bir ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," yanıtı"," ","döndürür. Her iki durumda da sipariş detayını kontrol edin ve destek ile iletişime geçin; ödemeniz kaybolmaz."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"süresi-dolmuş-sipariş","__idx":16},"children":["Süresi dolmuş sipariş"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ödenmeyen siparişler oluşturmadan yaklaşık bir saat sonra sona erer. Süresi dolmuş bir siparişi ödemek başarısız olur;"," ","yeni bir aramadan yeni bir sipariş oluşturun."]}]},"headings":[{"value":"Transfer Ödemesi","id":"transfer-ödemesi","depth":1},{"value":"İki Adımlı Ödeme Modeli","id":"i̇ki-adımlı-ödeme-modeli","depth":2},{"value":"Sipariş Ödemesi","id":"sipariş-ödemesi","depth":2},{"value":"Endpoint","id":"endpoint","depth":3},{"value":"Kimlik Doğrulama","id":"kimlik-doğrulama","depth":3},{"value":"Son Kullanıcı IP Adresi","id":"son-kullanıcı-ip-adresi","depth":3},{"value":"Yol Parametreleri","id":"yol-parametreleri","depth":3},{"value":"İstek Gövdesi","id":"i̇stek-gövdesi","depth":3},{"value":"Örnek İstek","id":"örnek-i̇stek","depth":3},{"value":"Yanıt","id":"yanıt","depth":3},{"value":"Ödeme Tamamlandı (200 OK)","id":"ödeme-tamamlandı-200-ok","depth":4},{"value":"Yanıt Alanları","id":"yanıt-alanları","depth":3},{"value":"Uç Durumlar","id":"uç-durumlar","depth":2},{"value":"Sipariş zaten ödenmiş (8009)","id":"sipariş-zaten-ödenmiş-8009","depth":3},{"value":"Eşzamanlı ödeme denemeleri (8008)","id":"eşzamanlı-ödeme-denemeleri-8008","depth":3},{"value":"Ödeme başarılı ama rezervasyon başarısız (8010)","id":"ödeme-başarılı-ama-rezervasyon-başarısız-8010","depth":3},{"value":"Süresi dolmuş sipariş","id":"süresi-dolmuş-sipariş","depth":3}],"frontmatter":{"seo":{"title":"Transfer Ödemesi"}},"lastModified":"2026-10-01T06:30:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/tr-tr/endpoints/transfer-payment","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}