Partner API Kullanım Kılavuzu

Lokanta, market veya kendi sipariş uygulamanızdan MotoTeslim kurye havuzuna paket göndermek için bu API'yi kullanın. Sipariş oluşturulunca kayıt doğrudan havuza düşer; yakındaki uygun kuryeler görür ve üstlenebilir.

Erişim

• Base URL: https://<PROJE_REF>.supabase.co/functions/v1
• Kimlik: X-Api-Key: mt_live_...
• İçerik tipi: application/json

Mototeslim.com.tr yöneticisinden API anahtarı talep etmek için ana sayfadaki formu doldurup usbkart@gmail.com adresine mail olarak gönderin. Anahtar size iletildikten sonra sunucu tarafında saklayın; mobil uygulamaya gömmeyin.

Uç Noktalar

• POST /partner-quote — mesafe ve acil / normal / rahat fiyat teklifi
• POST /partner-create-order — sipariş oluştur ve kurye havuzuna al
• GET|POST /partner-get-order — sipariş durumu sorgula

Ödeme Yöntemleri

• cash_sender — teslimat ücreti işletmeden / gönderenden nakit
• cash_receiver — teslimat ücreti alıcıdan nakit
• partner_prepaid — teslimat ücretini siz tahsil ettiniz

Ürün bedeli için opsiyonel goods_collect_amount_tl alanını kullanın (kapıda ürün tahsilatı).

Gönderilebilecek Bilgiler

• Gönderici adı, telefon ve alım adresi / koordinat
• Alıcı adı, telefon ve teslim adresi / koordinat
• Sepet: ürün adı ve adet
• Güvenli kapı, komşu / görevli, 3. kişi teslim tercihleri
• Ödeme yöntemi ve kapıda ürün tutarı

Önerilen Akış

1. Checkout'ta alıcı adresi ve koordinatları alın
2. İsteğe bağlı partner-quote ile ücreti gösterin
3. Ürün ödemesini kendi sisteminizde tamamlayın
4. partner-create-order ile siparişi havuza gönderin (external_id = sizin sipariş numaranız)
5. partner-get-order ile kurye durumunu izleyin

Kaynaklar

API Anahtar TalebiÖrnek UygulamaÖrnek JSON İndirOpenAPI (YAML)

Destek: usbkart@gmail.com

Ana sayfaya dön