Fejlesztő 6 perc olvasás

A Verification of Payee adatmodelljének megértése

Mielőtt egyetlen sor integrációs kódot írna, segít megérteni egy VoP csere formáját: a megadott mezőket, a kapott eredményeket és azokat a metaadatokat, amelyek segítenek cselekedni rajtuk.

By Tomaas Vento Starrantino · Reviewed by Donato Leone

A Verification of Payee adatmodelljének megértése

Főbb pontok

  • A VoP kérés a kedvezményezett nevére, az IBAN-ra és a számlatípusra összpontosít.
  • A válasz egy szabványosított eredményt ad vissza, támogató részletekkel.
  • A tiszta, strukturált bemeneti adatok javítják az egyezés pontosságát.

A Verification of Payee fogalmilag egyszerű: megkérdezi, hogy egy név egyezik-e egy IBAN-nal, és szabványosított eredményt kap vissza. Egy robusztus integráció azonban azon múlik, hogy megérti-e a csere minden részét, és tiszta adatokkal táplálja-e.

A kérés oldala

  • Kedvezményezett neve: a név, ahogyan várja, ideális esetben strukturáltan és tisztán.
  • IBAN: az ellenőrizendő számla.
  • Számlatípus: hogy a kedvezményezett személy vagy szervezet, ami befolyásolja az egyeztetést.
  • Kérési referencia vagy idempotenciakulcs, amely a hívást a rekordjaihoz kapcsolja.

A válasz oldala

  • Eredmény: egyezés, részleges egyezés, nincs egyezés vagy nem elérhető.
  • Részleges egyezés esetén a ténylegesen nyilvántartott név, hogy megmutathassa a fizetőnek.
  • Egy indok- vagy állapotkód, amely kontextust ad az eredményhez.
  • Egy azonosító, amellyel a naplóihoz és az egyeztetéshez korrelálhat.

Szemét be, gyenge egyezés ki

Az egyezés pontossága a bemenet minőségétől függ. A tiszta, jól strukturált nevek és a helyes számlatípus küldése érdemben javítja az eredményeket.

Tervezés a modell körül

A RoxPay Verification of Payee API-ja egyértelmű kérés/válasz modellt tesz elérhetővé szabványosított eredményekkel és támogató részletekkel, így az integrációja magabiztosan cselekedhet az eredmények alapján.

FAQ

Frequently asked

Elsősorban a kedvezményezett nevét, az IBAN-t, a számlatípust (személy vagy szervezet), valamint egy referenciát vagy idempotenciakulcsot, amely a hívást a rekordjaihoz kapcsolja.

Egy szabványosított eredményt - egyezés, részleges egyezés, nincs egyezés vagy nem elérhető -, valamint támogató részleteket, például a részleges egyezésnél nyilvántartott nevet és egy állapotkódot.

Az egyezés pontossága ettől függ. A tiszta, jól strukturált nevek és a helyes számlatípus érdemben javítják az ellenőrzési eredményeket.

Építsen egyértelmű adatmodellre

Beszéljen a RoxPay-jal egy tiszta kérés/válasz modellel rendelkező Verification of Payee API-ról.