Fejlesztő 5 perc olvasás

Idempotencia és egyeztetés a Verification of Payee API-ban

Egy robusztus Verification of Payee integráció két nem túl látványos valóságot kezel: a kéréseket újrapróbálják, és az eredményeket vissza kell párosítani a fizetésekhez. Mindkettő egyetlen szokáson múlik - egy stabil külső azonosító küldésén.

By Tomaas Vento Starrantino · Reviewed by Donato Leone

Idempotencia és egyeztetés a Verification of Payee API-ban

Főbb pontok

  • Küldjön stabil külső azonosítót minden ellenőrzési kéréshez.
  • Ez idempotenciát ad az újrapróbálkozásoknál, és kulcsot az egyeztetéshez.
  • Naplózza az azonosítót, az eredményt és a válaszoló BIC-et a tiszta auditnaplóhoz.

A legtöbb VoP integrációs útmutató ott ér véget, hogy „küldjön egy nevet és IBAN-t, olvassa ki az eredményt”. Az éles üzem két problémát hoz: a hálózatok meghibásodnak és a kliensek újrapróbálkoznak, majd a pénzügy később azt kérdezi: „melyik fizetéshez tartozott ez az ellenőrzés?”. Egyetlen mező - egy stabil külső azonosító kérésenként - mindkettőt megoldja.

Idempotencia az újrapróbálkozásoknál

Ha egy kérés időtúllépésbe fut, a kliens újrapróbálhatja. Idempotenciakulcs nélkül ez egy második ellenőrzés - többletköltség és zavaros naplók. Ugyanazon külső azonosító csatolása az újrapróbálkozáshoz lehetővé teszi a rendszer számára, hogy ugyanazon logikai kérésként ismerje fel, így az újrapróbálkozások biztonságosak.

Egy azonosító, egyszer generálva

A külső azonosítót a fizetési szándék létrehozásakor generálja, ne HTTP-kísérletenként. Így ugyanazon logikai ellenőrzés minden újrapróbálkozása ugyanazt az azonosítót hordozza.

Egyeztetés

Ugyanez a külső azonosító a korrelációs kulcsa. Tárolja a fizetési rekordján, küldje el az ellenőrzéssel, és később az ellenőrzés eredményét vissza tudja kapcsolni a pontos fizetéshez - elengedhetetlen a vitákhoz, auditokhoz és elemzésekhez.

Építse fel az auditnaplót

  1. 1 Generáljon egy külső azonosítót ellenőrzésenként, és mentse el a fizetésével együtt.
  2. 2 Küldje el a kérésben; használja újra minden újrapróbálkozásnál.
  3. 3 Naplózza a visszakapott ellenőrzési azonosítót, az eredményt és a válaszoló BIC-et hozzá.

A RoxPay Verification of Payee API-ja kérésenként elfogad egy külső azonosítót, és visszaadja a saját ellenőrzési azonosítóját a válaszoló BIC-cel, így az idempotencia és az egyeztetés egyetlen tiszta mintából következik.

FAQ

Frequently asked

Küldjön egy stabil külső azonosítót, amelyet logikai ellenőrzésenként egyszer generál (a fizetési szándék létrehozásakor), és használja újra az újrapróbálkozásoknál. A rendszer így az újrapróbálkozást ugyanazon kérésként ismeri fel, nem új ellenőrzésként.

Használja a külső azonosítót korrelációs kulcsként: tárolja a fizetési rekordon, küldje el az ellenőrzéssel, és ezzel kapcsolja az eredményt a fizetéshez.

A külső azonosítót, a visszakapott ellenőrzési azonosítót, az eredményt és a válaszoló BIC-et. Ezek együtt minden ellenőrzést egy fizetéshez és a válaszoló bankhoz kötnek.

Építsen robusztus VoP integrációt

Beszéljen a RoxPay-jal egy beépített idempotenciával és egyeztetéssel rendelkező Verification of Payee-ről.