BetakuryeGeliştirici

Canlıya geçiş

Sürüm geçmişi

v1 içinde alanlar yalnız eklenir, silinmez ve anlamı değişmez. Bilinmeyen alanı yok sayan istemci her sürümde çalışır.

11 Ekim 2026

  • Yeni: fee (kurye firmasının fiyat tablosuyla ücret), distance_m ve road_km teslimat yanıtında; teklifle aynı hesap
  • Yeni: customer.phone_extension (platform santrali dahili kodu): kurye santrali arar, uygulama kodu tuşlar; müşteriye SMS gitmez
  • Yeni: test: true (entegrasyon denemesi: kaydedilir, webhook gider, kuryeye düşmez, hemen iptal) ve yanıtta test
  • Yeni: GET /v1/deliveries?external_ref=…&external_store_id=… (kendi numarayla arama); 409 EXTERNAL_REF_TEKRAR yanıtında error.details.delivery_id
  • Yeni: items[].quantity ondalık olabilir (en çok 3 basamak)
  • Değişiklik: 0,0 ve Türkiye dışı konum yok sayılır (sipariş RECEIVED, adres çözümü); teklif ucu KONUM_GECERSIZ döner
  • Değişiklik: hizmet alanı dışındaki adres 422 HIZMET_DISI; askıdaki restorana POS siparişi 409 MAGAZA_PASIF (restoran paneliyle aynı kural)
  • Değişiklik: hız sınırı POS jetonuyla gelen isteklerde entegratör başına (dakikada 1.200); jetonsuz isteklerde IP başına 300
  • Düzeltme: POST /v1/stores konum ya da telefon göndermeyen POS kaydında kurye firmasının girdiği restoran konumunu ve telefonunu artık silmiyor
  • Yeni: POST /v1/quotes (hizmet alanı, tahmini süre, ücret) ve GET /v1/delivery-areas
  • Yeni: tracking_url (müşteri takip sayfası) ve GET /v1/public/tracking/{anahtar}; eta_pickup_at ve eta_dropoff_at artık dolu
  • Yeni: require_pin ve delivery_pin, pin_required (teslim PIN'i); GET /v1/deliveries/{id}/proofs (kapı fotoğrafı)
  • Yeni durumlar: RETURNING, RETURNED (iade) ve olaylar delivery.returning, delivery.returned; returned_at alanı
  • Yeni: delivery.courier_location olayı üretiliyor (yalnız açık abonelikle, sipariş başına en çok 30 sn'de bir)
  • Düzeltme: scheduled_for uygulanıyor (atama teslimden önce başlar); items, customer.note, payment.subtotal/discount, dropoff.district/neighborhood/city ve package_count saklanıp yanıtta dönüyor (önceden kabul edilip saklanmıyordu)
  • Yeni: deneme ortamı ve sanal kurye

10 Ekim 2026

  • Delivery API v1 ilk sürüm: OAuth client_credentials, restoran eşleme, sipariş oluşturma (idempotent), sorgulama, imleçli liste, güncelleme, iptal
  • Standard Webhooks imzalı olaylar, yeniden deneme takvimi, 410 ile abonelik kapatma