Başlarken

Deneme ortamı

Gerçek kurye ve restoran olmadan, canlı sistemle birebir aynı uçlarla deneyin. Sanal kurye siparişinizi kendiliğinden teslime götürür; webhook'lar gerçek gibi gelir.

Deneme kimliği almak

betakurye.com başvuru formunu “Yazılım firması” seçerek doldurun. Betakurye size üç şey iletir:

client_id (deneme kimlikleri bk_test_ ile başlar) ve client_secret
Bir eşleme kodu (30 gün geçerli): deneme restoranınızı bu kodla bağlarsınız

Adresler canlıyla aynıdır (https://betakurye.com). Ayrı bir deneme sunucusu yok; deneme kimliği sizi ayrı bir “deneme firmasına” bağlar.

Siparişiniz ne olur

Koordinatlı sipariş açtığınızda sanal kurye onu yaklaşık 15 saniye arayla bir sonraki duruma geçirir:

Zaman	Durum	Ne olur
0 sn	`QUEUED`	Sipariş açıldı (delivery.created, delivery.queued)
~15 sn	`ASSIGNED`	Sanal kurye atandı, adı "Sanal Kurye", plakası "DENEME"
~30 sn	`AT_PICKUP`	Kurye restoranda; konumu restoran
~45 sn	`PICKED_UP`	Paket kuryede
~60 sn	`EN_ROUTE`	Yolda; konumu restoranla adresin ortası
~75 sn	`ARRIVED`	Kapıda; konumu teslim adresi
~90 sn	`DELIVERED`	Teslim edildi; tahsil edilen tip siparişteki ödeme tipi

Her geçişte webhook adresinize gerçek olay gider (imzalı, yeniden denemeli). tracking_url sayfasını açarsanız kuryeyi haritada ilerlerken görürsünüz.

Canlıdan farkları

Kontör düşmez, ücret yoktur.
Müşteriye SMS gitmez. Takip bağlantısını kendiniz açarak bakın.
Koordinatsız sipariş (RECEIVED) bekler; sanal kurye ilerletmez. Adresi PATCH ile koordinatlı gönderince devam eder (canlıdaki adres doğrulama akışı gibi).
Sanal kurye PIN sormaz ve fotoğraf yüklemez; PIN'li sipariş de teslime gider.
İptal, güncelleme, teklif (/v1/quotes), hizmet alanı ve webhook uçları canlıyla aynı kurallarla çalışır.

Canlıya geçerken

Yalnız kimlik değişir: canlı client_id/client_secret ve her restoran için kendi kurye firmasının ürettiği eşleme kodu. Kodunuzda adres, alan ve olay adları aynıdır. Kontrol listesi: Canlıya geçiş.