> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryoto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Canlı kargo fiyatları için Checkout API

> OTO Checkout API ile ödeme sayfanızda gerçek kargo seçeneklerini, fiyatları ve tahmini teslimat sürelerini gösterin: ne istenir, ne döner ve nasıl gösterilir.

> [!NOTE]
>
> **Nerede bulunur:** Ayarlar → Developers → API Documentation — [OTO’da aç ↗](https://app.tryoto.com/api-integrations)

Çoğu ödeme sayfası kargo konusunda tahmin yürütür: sabit bir ücret, bir posta kodu tablosu ya da yazıldığından beri kimsenin bir kargo şirketiyle karşılaştırmadığı bir “3–5 iş günü” sözü.

## API ne işe yarar?

OTO; belirli bir çıkış noktası, varış noktası ve koli için hangi kargo şirketlerinin gönderiyi kabul edeceğini, her birinin size ne kadar ücret aldıracağını ve genellikle ne kadar sürede teslim ettiğini zaten bilir. Checkout API bu bilgiyi en önemli olduğu anda, yani müşteri karar verirken e-ticaret sitenize sunar.

Bu, [kargo şirketi seçiminin](https://docs.tryoto.com/tr/modules/shipping-management/carrier-integration.md) arka planda kullandığı motorun aynısıdır. Tek fark, soruyu kimin sorduğudur.

## Seçenekleri istemek

`POST /rest/v2/checkOTODeliveryFee`

| Alan | Zorunlu | Nedir? |
| - | - | - |
| `originCity` | Evet | Çıkış şehri, yani siparişin hangi hub’dan gönderileceği. |
| `destinationCity` | Evet | Müşterinin bulunduğu şehir. |
| `weight` | Evet | Kilogram cinsinden yaklaşık koli ağırlığı. |
| `originCountry` · `destinationCountry` | Hayır | Sınır ötesi gönderiler için ISO 3166-2 kodları. |
| `length` · `width` · `height` · `packageCount` | Hayır | Hacimsel ağırlığın veya çok kolili fiyatlandırmanın söz konusu olduğu durumlarda boyutlar ve koli sayısı. |
| `totalDue` · `currency` | Hayır | Kapıda ödeme ücretlerinin ve tutar limitlerinin uygulanabilmesi için sipariş tutarı. |
| `serviceType` | Hayır | Cevabı daraltır: **express**, **sameDay**, **fastDelivery**, **coldDelivery**, **heavyAndBulky**, **electronicAndHeavy**. |

## Ne döner?

Gönderiyi kabul eden her kargo hizmeti için bir tane olmak üzere teslimat seçenekleri listesi.

| Alan | Ne taşır? |
| - | - |
| `deliveryOptionName` · `deliveryCompanyName` | Hizmet ve onu sunan kargo şirketi. |
| `price` | Teslimat ücreti. |
| `avgDeliveryTime` | Okunabilir bir tahmin; örneğin *“1 to 2 Working Days”*. |
| `pickupCutOffTime` | Bir siparişin aynı gün yola çıkması için en geç kargoya verilebileceği saat; örneğin *17:00*. |
| `codCharge` · `maxCODValue` | Kapıda ödeme ücreti ve kargo şirketinin üzerinde tahsilat yapmadığı tutar sınırı. |
| `returnFee` · `insurancePolicy` | Bu hizmette iadenin maliyeti ve gönderi kaybolursa neyin karşılandığı. |
| `trackingType` · `pickupDropoff` | Kolinin nasıl takip edildiği ve kargoya nasıl teslim edildiği: **freePickup**, **dropoffOnly** veya **freePickupDropoff**. |

## Tahmini teslimat süresi ve teslim alma için son saat

İki zaman alanı farklı sorulara cevap verir ve ikisinin de ödeme sayfasında yeri vardır.

**Ortalama teslimat süresi** bir süredir: Bu hizmetin bu güzergâhta genellikle ne kadar sürdüğü. **Teslim alma için son saat** (pickup cut-off) ise bir son tarihtir: Bu saatten sonra verilen siparişlerde süre ertesi gün başlar.

> [!TIP]
>
> **Teslimat sözünü dürüst kılan son saattir**
>
> Akşam saat 9’da gösterilen “Ertesi gün teslimat”, işletmenin tutamayacağı bir sözdür ve müşteri bunu bir gün sonra öğrenir. “Yarın teslimat için 4 saat içinde sipariş verin” aynı bilgidir, ama harekete geçmek için hâlâ zaman varken söylenir.
>
> Son saatler, ödeme sayfasına koyabileceğiniz en etkili aciliyet unsurudur; çünkü gerçektirler. Geri sayım bir pazarlama numarası değil, operasyonunuzla ilgili bir gerçektir.

## Ödeme sayfasına eklemek

1. Müşteri bir teslimat adresi girer.
2. E-ticaret siteniz `checkOTODeliveryFee`’yi o şehir, sepetin ağırlığı ve gönderim yapacağınız hub ile çağırır.
3. Sunmak istediğiniz seçenekleri gösterirsiniz; genellikle hepsini değil, en ucuz ve en hızlı olanları. Yanlarına tahmini süreyi, son saat yaklaşmışsa son saati de eklersiniz.
4. Müşterinin seçimi siparişin teslimat seçeneği olur; böylece sipariş hazırlama, gerçekte satılanı gönderir.

> [!NOTE]
>
> **Aldığınızdan daha az seçenek gösterin**
>
> Dokuz kargo şirketi içeren bir cevap, sizin seçim yapacağınız bir listedir; müşteriye gösterilecek bir menü değildir. Kargo dokuz dallı bir karara dönüştüğünde ödeme sayfalarının dönüşüm oranı düşer.
>
> Sonuca göre adlandırılmış iki ya da üç seçenek (*Standart, Salı günü teslim* ve *Ekspres, yarın teslim*) aynı veriyi kullanır ve müşteriden daha azını ister.

## İlgili sayfalar

* [Kargo şirketi entegrasyonu](https://docs.tryoto.com/tr/modules/shipping-management/carrier-integration.md): bu seçeneklerin geldiği kargo şirketleri.
* [Kargo OTOmasyonu](https://docs.tryoto.com/tr/modules/shipping-management/shipping-automation.md): kimseye sorulmadığında kargo şirketinin nasıl seçildiği.
* [Hub Yönetimi](https://docs.tryoto.com/tr/modules/hubs-management/overview.md): tahminin hesaplandığı çıkış noktası.


## Related topics

- [REST API başvuru kaynağı](https://docs.tryoto.com/tr/developers/rest-api-reference.md)
- [OTO API’ye genel bakış](https://docs.tryoto.com/tr/developers/overview.md)
- [Kargo şirketi entegrasyonu ve yapılandırması](https://docs.tryoto.com/tr/modules/shipping-management/carrier-integration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.