IOSOR Gabay

Pagkakasunod-sunod ng Kaganapan kumpara sa Ledger Posting

Ang mga out-of-order na DLR at MO na kaganapan ay hindi dapat sumira sa mga patakaran ng prepaid debit posting — ang pagkakasunod-sunod ng pagdating ay hindi batas ng pera.

Naghahatid ang mga network ng mga callback nang hindi sunud-sunod. Ang huli na DLR, maagang MO, o pagbabago ng status bago ang settle ay hindi dapat mag-imbento ng pangalawang debit o mag-overwrite ng naka-ayos na row. Ang pahinang ito ay ang posting-order contract: ang mga patakaran ng ledger ay nakakatagal sa pag-reorder — hindi ito isang primer sa correlation-ID o sanaysay sa pag-singil ng MO laban sa MT.

Ang pagkakasunod-sunod ng pagdating ay hindi batas ng ledger

Ang pagdating sa HTTP ay isang aksidente sa transportasyon. Ang pera ay naka-post sa ilalim ng hold → settle → outcome-update — hindi «kung aling callback ang huling lumapag». Ang malambot na USD 1,000/month ay tumuturing sa pag-reorder bilang insidente sa pananalapi kapag ang produkto ay nagpapakita ng tagumpay habang ang ledger ay nadoble ang galaw. Pinatutunayan ng USD 20 na ang pinilit na huli na DLR ay hindi kailanman nagbubukas ng parallel debit.

Ano ang hitsura ng out-of-order

Pattern ng pagdating Ligtas na pag-post Hindi ligtas na reaksyon
DLR bago ang settle Nakabinbin; i-settle minsan sa ilalim ng hold Debit mula sa DLR lamang
Nabigo pagkatapos ay inihatid I-update ang resulta sa lugar Pangalawang singil para sa pag-flip
MO bago ang MT correlate I-file ang inbox; i-join sa MT settle Singilin ang MO bilang outbound
Status pagkatapos ng refund Walang bagong pera; lagyan ng anotasyon I-resettle ang inilabas na layunin
Dalawang terminal, isang

Mga patakaran sa pag-post na nakakatagal sa pag-reorder

Mag-mint ng hold at idempotency keys bago ang mga side effect (Webhook kontrata bago ang unang send). Mag-settle nang isang beses bawat nasisingil na layunin; ang mga susunod na kaganapan ay nag-a-update lamang ng kinalabasan. Huwag kailanman magbukas ng parallel debit para sa maaga o huli na DLR o MO. Tanggihan o iparada sa labas ng naka-sign na window — walang naiimbentong tagumpay.

Normal ang lag; hindi normal ang dobleng pera

Ang lag sa network ay hindi kailanman dahilan para i-charge nang dalawang beses ang isang layunin. Ang bawat entry sa ledger ay kailangang magbalanse nang eksakto. Kapag may mga isyu sa latency, ang iyong sistema ay hindi dapat lumikha ng pangalawang hilera ng debit. Palaging magtiwala sa layunin kaysa sa arbitraryong timestamp.

Checklist ng mamimili para sa pagkakasunod-sunod ng kaganapan kumpara sa pag-post

I-verify na ang iyong sistema ay sumusulat sa ledger nang eksakto isang beses bawat kaganapan ng pagsingil. Suriin na ang mga huli na DLR ay binabalewala kung ang pag-ayos ay nakumpleto na. Siguraduhin na ang MO at MT ay maayos na pinagsasama nang walang karagdagang bayad. At laging suriin na ang iyong diskarte sa webhook replay ay ligtas.

Magsimula sa IOSOR

Sa console: Event order vs ledger posting must reconcile by shared id.. Pangalanan ang may-ari at gate bago mag-scale.

Kaugnay: duplicate webhook no second debit webhook consumer ops at volume

Buod ng IOSOR

Ito ay ops disiplina para sa duty—hindi brochure.

Gawin: name owner + gate. Huwag: skip the gate.

Nakatulong ba ang gabay na ito?

Mga kaugnay na gabay