IOSOR Rehber

Olay sırası ve defter kaydı karşılaştırması

Sırası bozulmuş DLR ve MO olayları ön ödemeli borçlandırma kurallarını bozmamalıdır; varış sırası para kanunu değildir.

Ağlar geri aramaları düzensiz bir sırada teslim eder. Gecikmeli bir DLR, erken bir MO veya mutabakat öncesi durum taklası ikinci bir borçlandırma icat etmemeli veya mutabakata varılmış bir satırı yeniden yazmamalıdır. Bu sayfa defter sırası sözleşmesidir; defter kuralları yeniden sıralamaya karşı dayanıklıdır — ne bir korelasyon kimliği kılavuzu ne de bir MO-MT faturalandırma denemesidir.

Varış sırası defter kanunu değildir

HTTP varışı bir taşıma kazasıdır. Para; tutma (hold) → mutabakat (settle) → sonuç güncellemesi sırasıyla kaydedilir — «hangi geri arama en son geldiyse» mantığıyla değil. Esnek bir USD 1.000/ay değeri, ürün başarı gösterirken defter çift hareket ettiğinde yeniden sıralamayı bir finansal olay olarak ele alır. USD 20, zorlanmış geç bir DLR'nin asla paralel bir borçlandırma açmadığını kanıtlar. Aynı kimlikli tekrarlar: Yinelenen webhook ikinci bir borçlandırma yaratmamalıdır.

Düzensizliğin pratik görünümü

Varış düzeni Güvenli kayıt Güvensiz tepki
Mutabakattan önce DLR Beklemede; tutma altında bir kez mutabakat Yalnızca DLR'den borçlandırma
Önce başarısız sonra teslim Sonucu yerinde güncelle Durum taklası için ikinci ücret
MT korelasyonundan önce MO Gelen kutusuna kaydet; MT mutabakatında birleştir MO'yu giden olarak ücretlendir
İadeden sonra durum Yeni para yok; not düş Serbest bırakılan niyeti yeniden mutabakata aç
İki terminal, bir niyet Tek bir para satırı İki borç satırı

Yeniden sıralamaya direnen kayıt kuralları

Yan etkilerden önce tutma ve teklik (idempotency) anahtarları üretin (İlk gönderimden önce webhook sözleşmesi). Faturalandırılabilir niyet başına bir kez mutabakat sağlayın; sonraki olaylar yalnızca sonucu günceller. Erken veya geç DLR için asla paralel bir borçlandırma açmayın. İmzalı pencerenin dışındaki istekleri reddedin veya park edin; asla hayali bir başarı üretmeyin. Dışa aktarımlar varış zaman damgasına göre değil, niyete göre birleştirilir.

Gecikme normaldir; çift para normal değildir

Ağ gecikmesi her zaman yaşanacaktır ancak bütçe sızıntısı kabul edilemez. Bir olay geciktiğinde sistem beklemeyi bilmelidir. Her bir finansal işlem doğru sırayla işlenmelidir.

Olay sırası için alıcı kontrol listesi

Sunucunuzun tüm gelen istekleri güvenli bir şekilde işlediğinden emin olun. Kimlik doğrulama katmanını atlamayın. Her zaman idempotency anahtarlarını kontrol edin. Yanlış sıralanmış verilerin defterinizi bozmasına asla izin vermeyin.

IOSOR ile başlayın

Konsolda: Event order vs ledger posting must reconcile by shared id.. Ölçeklemeden önce sahibi ve kapıları yazın.

İlgili: duplicate webhook no second debit webhook consumer ops at volume

IOSOR özeti

Bu nöbete uygun ops disiplinidir—broşür değil.

Yapın: name owner + gate. Yapmayın: skip the gate.

Bu rehber yardımcı oldu mu?

İlgili rehberler