Shipy entegrasyonu Webhook güvencesi, modern API ve YZ fraud
Ödeme bildirimi gelmediğinde sipariş ortada kalıyor: para alınmış ama sipariş ödenmemiş görünüyor. Shipy’nin webhook mimarisi bu boşluğu kapatmak için tasarlanmış bir altyapı sunuyor.
- Kesintisiz webhook
- İmza doğrulamalı
- YZ destekli fraud
- Sipariş başına ek ücret yok
Neden Shipy?
Shipy entegrasyonu neyi ortadan kaldırır?
Shipy’nin öne çıkan tarafı API tasarımı. Alan adları sade, hata yanıtları açıklayıcı ve dokümantasyon örneklerle destekli. Geliştirici ekibi olan satıcı için bu, ödeme akışını kendi uygulamasına bağlamayı kolaylaştırıyor. Zeoks tarafında ise bu API’nin karmaşıklığı sizin için görünmüyor; anahtarları girip yöntemi açıyorsunuz.
Webhook, ödeme sağlayıcısından sipariş sistemine gelen asenkron bildirim. Kullanıcı 3D ekranından dönerken tarayıcı kapanabilir, internet kesilebilir ya da geri dönüş adresi yüklenemeyebilir. Bu durumda siparişin ödendiğini öğrenmenin tek güvenilir yolu webhook. Shipy’nin kesintisiz bildirim mantığı, kaçırılan bir bildirimi tekrar denemeye alıyor. Zeoks gelen bildirimi imza ve sipariş kimliğiyle doğrulayıp durumu güncelliyor.
Yapay zekâ destekli fraud kontrolü, kural listesinin ötesine geçiyor. Klasik sistemler sabit eşiklerle çalışır: şu tutarın üzeri, şu ülkeden gelen, şu saatte yapılan. Model tabanlı yaklaşım ise davranış örüntüsüne bakıyor; aynı cihazdan farklı kart denemeleri, sepete ekleme ile ödeme arasındaki anormal süre ve tipik müşteri profiline uymayan hareketler birlikte değerlendiriliyor. Yanlış pozitif oranı düşüyor, yani gerçek müşteri daha az reddediliyor.
Modern API’nin bir başka avantajı, geliştirilebilir olması. Zeoks ödeme sonucunu siparişe yazmanın ötesine geçmiyor ama bu kayıt üzerinden kendi raporlarınızı, mutabakat dökümünüzü ve kâr analizinizi kurabilirsiniz. Komisyon ve ödeme takvimi Shipy sözleşmenizde; Zeoks satışınızdan ek pay almıyor.
Öne çıkanlar
Shipy ile gelen özellikler
Gönderi açmaktan iadeye kadar her adım aynı sipariş kaydının içinde kalır.
-
Kesintisiz webhook
Müşteri 3D ekranından dönerken tarayıcı kapanabilir. Shipy ödeme sonucunu arka planda bildirir; kaçırılan bildirim tekrar denemeye alınır, sipariş ortada kalmaz.
-
İmza doğrulamalı bildirim
Zeoks gelen bildirimin imzasını ve sipariş kimliğini doğrulamadan durumu değiştirmiyor. Dışarıdan atılan sahte bir istek siparişi ödenmiş gibi kapatamıyor.
-
Modern ve sade API
Alan adları sade, hata yanıtları açıklayıcı, dokümantasyon örnekli. Geliştirici ekibi olan satıcı ödeme akışını kendi uygulamasına kolayca bağlayabiliyor.
-
YZ destekli fraud
Kural listesi yerine davranış örüntüsü inceleniyor: cihaz, zamanlama, sepet geçmişi birlikte değerlendiriliyor. Yanlış ret oranı düştüğü için gerçek müşteri daha az reddediliyor.
-
Tekrarlı bildirim koruması
Aynı bildirim iki kez gelse bile sipariş iki kez ödenmiş sayılmıyor. İşlem kimliğine göre tekilleştirme, stoktan çift düşüşü engelliyor.
-
Panelden kurulum
Anahtarlar ve webhook adresi panelden tanımlanır, kod yazılmaz. Yöntem paketin içindedir; ödeme başına ayrıca yazılım ücreti kesilmez.
Kurulum
Shipy kurulumu ne kadar kolay?
Kurulum nasıl yapılır? Hesabı firmada siz açıyorsunuz; Shipy tarafındaki sözleşme ve ücretlendirme sizinle onlar arasında. Zeoks’ta yaptığınız iş, paneldeki alanları doldurup yöntemi açmaktan ibaret. E-ticaret siteniz başvuru onayından sonra açılır, ilk 3 ay ücretsizdir.
-
Shipy API anahtarlarını oluşturun
Shipy panelinde mağaza oluşturup API anahtarlarını üretin. Test ve canlı anahtarları ayrıdır; önce test anahtarıyla ilerlemek, canlıya geçerken sürpriz yaşamamanızı sağlar.
-
Webhook adresini ve imza doğrulamasını bağlayın
Zeoks ödeme ayarına anahtarları yazın ve webhook adresini Shipy panelinde tanımlayın. İmza doğrulaması açık kalsın; imzasız bildirimden sipariş durumu değişmemeli.
-
Bildirim tekrarını deneyin
Deneme siparişinden sonra aynı bildirimi iki kez gönderin. Siparişin iki kez ödenmiş sayılmadığını ve stoktan iki kez düşmediğini doğrulayın. Bu test, üretimde en sık karşılaşılan hatayı yakalar.
Kazanım
Shipy entegrasyonu ile neler kazanırsınız?
- Sade ve dokümante API
- Kesintisiz webhook bildirimi
- Tekrarlı bildirim koruması
- YZ destekli fraud kontrolü
- Düşük yanlış ret oranı
- Zeoks satıştan pay almaz
Operasyon notu
Shipy entegrasyonu operasyonda neyi değiştirir?
Ödeme bildiriminin kaybolduğu senaryolar
3D Secure doğrulaması müşteriyi bankanın sayfasına götürüp geri getiriyor. Bu gidiş-dönüşte dört farklı şey ters gidebilir: tarayıcı sekmesi kapanır, mobil veri kesilir, geri dönüş adresi hata verir ya da kullanıcı beklemeden sayfayı kapatır. Dördünde de kart işlemi başarılı olabilir, çünkü işlem banka tarafında tamamlanmıştır.
Bu noktada satıcı ile ödeme sağlayıcısı arasındaki tek köprü webhook. Bildirim gelmiyorsa sipariş ödeme bekliyor durumunda kalır, para hesaba geçer ama ürün kargoya verilmez. Müşteri bekler, destek arar, güven sarsılır. Üstelik bu hata bir kez olduğunda tekrar etme olasılığı yüksek.
Güvenilir webhook mimarisi iki şeyi yapıyor: bildirimi tekrar deniyor ve tekilleştiriyor. Tekrar deneme, geçici ağ hatalarında siparişin sonunda doğru duruma gelmesini sağlıyor. Tekilleştirme ise aynı bildirimin iki kez işlenmesini engelliyor. İkisi birlikte olduğunda ödeme durumu siparişle senkron kalıyor.
Düşük yanlış ret oranının ciro etkisi
Fraud kontrolü, görünmeyen bir ciro kalemi. Her yanlış ret, gerçek bir müşterinin kaybedilmesi demek ve bu müşteri çoğu zaman bir daha geri dönmüyor. Ödeme sayfasında reddedilen kullanıcı, kartının kötü olduğunu düşünüp başka bir satıcıya gidiyor. Satıcı ise kaybettiği satışı hiç görmüyor.
Klasik eşik tabanlı sistemlerde yanlış ret oranı yüksek olabiliyor. Yeni bir şehirden, yeni bir cihazdan ve yüksek tutarlı ilk alışveriş yapan bir müşteri, kural motoruna şüpheli görünüyor. Oysa bu profil, en kârlı müşteri olabilir. Davranış örüntüsüne bakan modeller bu ayrımı daha iyi yapıyor.
En pratik ölçüm, reddedilen işlemleri de tamamlananlar kadar izlemek. Hangi tutar aralığında ret oranı yüksek, hangi kanaldan gelen müşteri daha çok reddediliyor, aynı müşteri ikinci denemede geçiyor mu? Bu üç sorunun cevabı, fraud ayarını veriye dayalı hâle getiriyor. Sabit kural yazmak yerine ölçüp ayarlamak kalıcı kazanç sağlıyor.
Rehber
E-Ticaret Ödeme Optimizasyonu: Teknik Altyapı ve Fraud Dengesi
Ödeme altyapısının güvenilirliği, satış rakamlarının altında görünmeyen bir katman. Aşağıdaki iki başlık bu katmanı iş sonucuna çevirmenin yolunu anlatıyor.
Ödeme altyapısında güvenilirlik ölçümü
Bir ödeme altyapısının başarısı, çalıştığı günlerde değil, bozulduğu günlerde belli oluyor. Ölçülmesi gereken üç metrik var: ödeme başlatma ile sonuç alma arasındaki süre, başarısız bildirim oranı ve sipariş ile tahsilat eşleşme yüzdesi. Üçüncü metrik en kritik olanı.
Sipariş ile tahsilat eşleşmesi tutmuyorsa, bir yerde para alınmış ama sipariş oluşmamış ya da tersi olmuş demektir. Bu farkı haftada bir mutabakatla kapatmak, ay sonunda yaşanacak büyük mutabakat sıkıntısını önlüyor. Küçük farklar erken görüldüğünde düzeltmek kolay; biriktiğinde ise hangi siparişin hangi tahsilata ait olduğunu bulmak imkânsızlaşıyor.
Bir ipucu: teknik ekibi olmayan satıcı için bile basit bir kontrol yeterli. Her hafta sonu sipariş listesini ödeme durumuna göre filtreleyin. Ödeme bekleyen sipariş sayısı sürekli artıyorsa altyapıda bir sorun var demektir; bu sayı sabit kalıyorsa akış sağlıklı.
Fraud ayarını büyümeyle birlikte kalibre etmek
Yeni açılan bir mağazada fraud ayarını çok sıkı tutmak, ilk müşterileri kaybetmenin en hızlı yolu. Hacim düşükken kural motoru yeterli veriye sahip olmuyor ve şüpheli görünen her işlem reddediliyor. Bu dönemde amaç, gerçek müşteriyi kaçırmadan temel korumaları açık tutmak.
Hacim arttıkça kalibrasyon mümkün hâle geliyor. Hangi ürün grubunda iade oranı yüksek, hangi tutar aralığında ters ibraz geliyor, hangi kanaldan gelen müşteri daha çok şüpheli işlem üretiyor? Bu verilerle eşikleri ayarlamak, sabit bir kural setiyle çalışmaktan çok daha etkili.
Son nokta: fraud kararı ile müşteri deneyimi arasında bir denge var. Yüksek tutarlı bir sepet ek doğrulama isteyebilir; bu normal ve müşteri bunu anlıyor. Ancak düşük tutarlı bir sepette aynı doğrulamayı istemek, gereksiz sürtünme yaratır. Sepet tutarına göre kademeli davranmak, iki tarafı da memnun eden tek yaklaşım.
Sıkça sorulanlar
Shipy entegrasyonu hakkında sık sorulan sorular
Çünkü kullanıcı 3D doğrulamasından dönerken tarayıcı kapanabilir, bağlantı kesilebilir ya da geri dönüş adresi yüklenemeyebilir. Bu durumda ödemenin alındığını öğrenmenin tek güvenilir yolu arka planda gelen bildirimdir. Webhook olmadan sipariş ödeme bekliyor durumunda kalır.
Shipy panelinden alınan API anahtarları ve tanımlanmış bir webhook adresi. Anahtarları Zeoks ödeme ayarına yazıp yöntemi aktif ediyorsunuz. Önce test anahtarıyla çalışmak, canlıya geçerken sürpriz yaşamamanızı sağlar.
Klasik sistemler sabit eşikler kullanır: şu tutarın üzeri, şu ülkeden, şu saatte. Model tabanlı yaklaşım ise davranış örüntüsüne bakar; aynı cihazdan farklı kart denemeleri, sepet ile ödeme arasındaki anormal süre ve tipik profilin dışına çıkan hareketler birlikte değerlendirilir. Bu, yanlış ret oranını düşürür.
İşlem ve sipariş kimliğine göre tekilleştirme yapılıyor. Aynı bildirim tekrar gelse bile sipariş ikinci kez ödenmiş sayılmıyor ve stoktan ikinci kez düşmüyor. Bu senaryo, ağ tekrarında en sık karşılaşılan hata olduğu için ayrıca test edilmiş durumda.
Oran sizin Shipy sözleşmenizde, iş hacmi ve taksit yapısına göre belirlenir. Zeoks bu orana karışmaz, satışınızdan ayrıca pay almaz. Ödeme yöntemi paketin içindedir, ayrı modül faturası çıkmaz.
Shipy alternatif ödeme vizyonu olan bir sağlayıcı; sunduğu kanallar sözleşmeniz ve hesap ayarlarınızla belirlenir. Zeoks vitrinde yalnızca hesabınızda açık olan yöntemleri gösterir. Kripto gibi özel kanalların mevzuat durumunu kendi hukuk danışmanınızla teyit etmeniz gerekiyor.
Entegrasyon talebi
Zeoks ile mağazanız satışa hazır.
İlk 3 ay ücretsiz başlar, sonra yıllık paket işler. Ayrıca modül ücreti kesilmez.
Bu sayfadaki entegrasyon paketin içindedir. Takıldığınız yerde formu bırakın, sizi arayalım.
Ödeme bildiriminin kaybolması, en zor teşhis edilen hataların başında geliyor. Shipy’yi bağlayıp kendi hesabınızla deneyebilirsiniz. Webhook ya da anahtar tarafında takılırsanız formu bırakın.
Ödeme entegrasyonları
