Veni Developers

Görünüm

Veni APISiparişi kendi sisteminize taşıyın

Olup biteni imzalı webhook'larla alırsınız; menüyü, sipariş durumunu ve teslimat taleplerini REST uçlarından gönderirsiniz.

Başlayın
Webhook imzası
Erişim başvurusu

Webhook'lar

Sipariş durumu değiştiğinde adresinize imzalı bir POST gider. Ulaşamazsak yeniden deneriz, her deneme kayda geçer, olay kaybolmaz.

POS API

Restoranın menüsünü yazar, siparişlerini okur, durumunu ilerletirsiniz. Altı uç, tek restoranla sınırlı bir anahtar.

Partner API

Kendi müşteriniz için Veni kuryesi çağırır, teslimatı sorgular ve iptal edersiniz. Kart bilgisi hiçbir uçtan geçmez.

Hangi yüzeye ihtiyacınız var ​

Ne yazıyorsunuzAradığınız yüzeyBuradan başlayın
Adisyon ya da POS yazılımı — menü restorana iki kez girilmesin, Veni siparişi sizin ekranınızda görünsünPOS API + webhookPOS API
Tek bir restoranın kendi yazılımı — Veni'den gelen sipariş kendi ekranına düşsünWebhook (gerekirse POS API)Erişim modeli
Kendi müşterisine kurye gönderen bir sistem — eczane, çiçekçi, e-ticaretPartner APITeslimatlar

Hangisi olduğundan emin değilseniz Erişim modeli üç kapıyı yan yana koyar.

Nasıl çalışır ​

Veni'de bir şey olduğunda adresinize imzalı bir istek göndeririz; imzayı doğrular, işinizi yapar ve 2xx dönersiniz. Ters yönde de çalışır: menüyü, sipariş durumunu ya da teslimat talebini siz bize gönderirsiniz.

Üç yüzey var ve kapıları farklıdır:

YüzeyAnahtarı kim açarNe işe yarar
Restoran webhook'larıRestoran panelden açar ve entegratör olarak sizi seçerSipariş durumu değişince haber almak
POS APIRestoran panelden anahtar üretir ve entegratör olarak sizi seçerMenü yazmak, sipariş okumak, durum güncellemek
Partner APIVeni, anlaşma sonrası üretirKendi müşteriniz için kurye ve teslimat açmak

Üçünün ortak koşulu: Veni ile anlaşmanız olmalı. Anahtarı ve webhook'u restoran kendi panelinden açar, ama yalnız anlaşması aktif bir entegratöre bağlayabilir. Başvuru: veni.com.tr/iletisim.

Kapsam dışı ​

  • Ödeme ağ geçidi değil. Hiçbir uçta kart bilgisi istenmez. Ödeme iyzico tarafında 3DS ile tamamlanır; teslimat yanıtındaki yönlendirme adresini kullanıcıya açmanız yeterlidir.
  • Veri ve raporlama API'si yok. Ciro özeti, müşteri listesi ya da analitik veren bir uç yoktur. Okuyabildiğiniz tek şey bağlı olduğunuz restoranın kendi siparişleridir.

Test ortamı ​

İzole bir test restoranı ve vnrs_test_ ön ekli bir anahtar veriyoruz: entegrasyonun sözleşme tarafını (alan okuma, eşleme, imza, durum zinciri) canlı veriye dokunmadan bitirirsiniz. Fiyatlama, kampanya ve ödeme o yolda koşmaz; para tarafı canlıda küçük tutarlarla doğrulanır. Test ortamı

Koda başlamadan önce ​

  1. Anlaşma. Entegratör olarak başvurur, anlaşmayı imzalarsınız. Sonrasında müşteriniz olan restoran kendi panelinden anahtarı üretip sizi seçer.
  2. HTTPS bir adres (webhook alacaksanız). İmzayı doğrulamak için isteğin ham gövdesine erişmeniz gerekir; gövdeyi yeniden serileştiren bir ara katman imzayı bozar.
  3. Olayı tekilleştirecek bir yer. Aynı olay iki kez gelebilir. X-Veni-Delivery değerini kaydedip tekrarını atlarsınız.

Başlangıç sayfası ilk webhook'u on dakikada ayağa kaldırır.