IOSOR

IOSOR Rehber

İlk gönderimden önce webhook sözleşmesi

Alıcı yolu: İlk ön ödemeli gönderimden önce imzalı URL'yi, olay türlerini ve tekilleştirme anahtarını onaylayın — önce sözleşme, sonra ücretli trafik.

Ön ödemeli bir gönderim, ortak bir gerçeğe dayanmayan webhook sözleşmesi olmadan harcanan paradır. Finans departmanı durum ile defterin neden uyuşmadığını sormadan önce; alıcılar imzalı URL'yi, olay listesini ve tekilleştirme anahtarını ilk ücretli mesaj cüzdanı terk etmeden önce kilitlemelidir. Bu sayfa bir 'lansmanda anahtarlar' kontrol listesi veya imza incelemesi değil, alıcı yoludur.

İlgili: lansmanda webhook ve anahtarlar, lansmanı ayakta tutan webhook’lar, ilk tahsilattan önce ön ödemeli bakiye rezervi, 1. Gün pisti: neyin yeşil olması gerekir.

IOSOR beyaz etiketli ön ödemeli bir sistemdir.

İlk ücretli gönderimden önce sözleşmeyi onaylayın

Ücretli gönderim, cüzdanın borç kaydedebileceği anlamına gelir. Sözleşme ise ürün, finans ve operasyon ekiplerinin geri aramaların nereye varacağını, hangi olayların para veya durum gerçeği olarak sayılacağını ve hangi anahtarın yeniden denemeleri güvenli kıldığını şimdiden paylaştığı anlamına gelir. Lansman alışkanlıkları ve pist, sözleşme hâlâ bir Slack yazışması düzeyindeyken yeşil görünebilir — bu hazır olunduğu anlamına gelmez. Bkz. lansmanda webhook ve anahtarlar ve 1. Gün pisti: neyin yeşil olması gerekir.

İmzalı URL ve tüketici sahipliği

Sözleşme alanı Alıcılar neden önemser?
HTTPS geri arama URL'si Ürün ve operasyonun adını koyabildiği tek hedef
İmza gizli anahtarı sahibi Kimin döndüreceği; asla ortak sohbete atılmaz
ACK ve işlem kuralı Önce kalıcı hale getir; yan etkiler ACK sonrasında
Ortam ayrımı Pilot URL ≠ üretim URL'si
Bilinmeyen sunucuda hata ile kapanma Sahte teslimat defteri asla güncellemez

Ürün ve finansın paylaştığı olay türleri

İlk gönderimden önce para veya durum değiştirebilecek olayları listeleyin: kabul edildi, teslim edildi, başarısız oldu, süresi doldu, gelen DUR (STOP) komutu ve doğruluk kabul ettiğiniz her doğrulama sonucu. Listelenmeyen olaylar kapalı duruma geçer — deftere yeni satırlar eklemezler. Ortak terimler: Ürün ve finans için ortak durum dili.

Harcamadan önce tekilleştirme anahtarı

Tekilleştirme anahtarı, ağ hatalarını finansal riskten ayırır. Bir webhook'un iki kez tetiklenmesi durumunda, anahtar defterin sadece bir kez borçlanmasını sağlar. Bu anahtar, ilk mesaj gönderilmeden önce sistemler arasında sabitlenmelidir.

Webhook sözleşmesi için alıcı kontrol listesi

Sözleşme, teknik bir yapılandırmadan ziyade operasyonel bir mutabakattır. Tüm taraflar, hangi olayların cüzdan bakiyesini etkileyeceği konusunda hemfikir olmalıdır. Bu mutabakat olmadan yapılan her gönderim, finansal bir belirsizlik yaratır.

IOSOR ile başlayın

Ücretli mesaj gönderimlerini etkinleştirmeden önce IOSOR konsoluna girin ve imzalı HTTPS geri arama adresinizi belirlenen tekillik anahtarı alanıyla birlikte kaydedin. Listelenmeyen geri aramaların otomatik olarak başarısız olmasını sağlamak üzere ürün, finans ve mühendislik ekip liderlerinin teslim edildi, başarısız oldu ve süresi doldu gibi paylaşılan olay şemasını incelediğinden emin olun. Trafik kısıtlamalarını kaldırmadan önce yeniden denemelerin tek bir defter satırına kaydedildiğini doğrulamak için web kancası geçidiniz üzerinden harcama gerektirmeyen bir mükerrer olay yükü testi çalıştırın.

IOSOR özeti

Bir web kancası sözleşmesi gayriresmi bir mutabakat değildir; finans ve ürünü mükerrer borçlandırmalardan ve hayalet durum güncellemelerinden koruyan açık bir sınırdır.

Bu rehber yardımcı oldu mu?

İlgili rehberler