Teslimat API'si · v1

Kurye çağırmayı yazılımınıza ekleyin

POS, adisyon ve sipariş yazılımınızdan Betakurye kuryesi çağırın. Siparişi tek istekle gönderirsiniz; kurye atanınca, paket alınınca ve teslim edilince imzalı webhook ile haber alırsınız.

Betakurye, restoranların paket servisini kurye firmalarına bağlayan bir kurye platformudur. Restoranınızın kurye firması Betakurye kullanıyorsa, yazılımınız siparişi doğrudan o firmanın kurye havuzuna iletebilir. Kuryeyi en yakın ve uygun olanı sistem atar; siz yalnız siparişi gönderir ve durumu izlersiniz.

Nasıl çalışır

Kimlik: Betakurye size bir client_id ve client_secret verir; bunlarla 30 dakikalık erişim jetonu alırsınız.
Restoran bağlama: Kurye firması restoran için bir eşleme kodu üretir. Yazılımınız restoranı bu kodla bir kez kaydeder; sonra restoranı kendi kimliğinizle (external_store_id) anarsınız.
Sipariş: POST /v1/deliveries. Aynı siparişi iki kez gönderseniz de (ağ koptu, yeniden denediniz) tek teslimat açılır.
Durum: Her durum değişikliği webhook adresinize imzalı olarak gelir. İsterseniz GET /v1/deliveries ile de sorarsınız.

Bir siparişin yolculuğu

Durağa dokunun: o durumu kim tetikler, adresinize hangi olay gider.

Kurye aranıyor · QUEUED

Sipariş atama sırasında. İleri tarihli siparişte (scheduled_for) atama teslim anından firmanın ayarı kadar (varsayılan 30 dk) önce başlar.

Tetikleyen: Sistem · Webhook: delivery.created · delivery.queued

Üst sıra: olağan yolAlt sıra: iptal, teslim edilememe, iadeYeşil kenarlı: son durum

Neler var

Sipariş oluşturma, sorgulama, güncelleme (kurye paketi almadan önce) ve iptal
Sipariş öncesi teklif: hizmet alanında mı, kaç dakikada gelir, ücret ne (POST /v1/quotes)
İleri tarihli teslimat (scheduled_for), sipariş kalemleri, müşteri notu
Müşteriye canlı takip bağlantısı (tracking_url) ve tahmini varış (eta_dropoff_at)
Teslim kanıtı: kapıda konum denetimi, 4 haneli teslim PIN'i, kapı fotoğrafı
İade akışı: teslim edilemeyen paketin restorana dönüşü
Deneme ortamı: sanal kurye siparişinizi kendiliğinden teslime götürür

Hızlı başlangıçBeş adımda ilk siparişi gönderin.Deneme ortamıGerçek kurye olmadan uçtan uca deneyin.UçlarHer uç, alanlarıyla ve gerçek yanıt örneğiyle.WebhookOlaylar, imza doğrulama (Node, PHP, C#), yeniden deneme.

Temel bilgiler

Taban adres	`https://betakurye.com`
Biçim	JSON, UTF-8. Alan adları `snake_case`.
Kimlik	OAuth 2.0 `client_credentials`, `Authorization: Bearer …`
Zaman	ISO 8601, saat dilimi zorunlu (`2026-10-11T19:30:00+03:00` ya da `…Z`). Yanıtlar UTC.
Para	Türk lirası, en çok iki ondalık (`249.90`)
Telefon	Türkiye numarası; `05321234567`, `+905321234567` biçimleri kabul edilir
Sürüm	v1, tarih sürümü `2026-10-10` (`GET /healthz` yanıtında). Alanlar eklenir, silinmez; yeni alanları yok sayan istemci bozulmaz.