La Verification of Payee è concettualmente semplice: chiedi se un nome corrisponde a un IBAN e ricevi un esito standardizzato. Ma un'integrazione robusta dipende dal comprendere ogni parte di quello scambio e dall'alimentarla con dati puliti.
Il lato richiesta
- Nome del beneficiario: il nome come te lo aspetti, idealmente strutturato e pulito.
- IBAN: il conto da verificare.
- Tipo di conto: se il beneficiario è una persona o un'organizzazione, il che incide sulla corrispondenza.
- Un riferimento di richiesta o chiave di idempotenza per legare la chiamata ai tuoi record.
Il lato risposta
- Esito: corrispondenza, parziale, nessuna o non disponibile.
- Per una corrispondenza parziale, il nome effettivamente registrato, così puoi mostrarlo a chi paga.
- Un codice di motivo o stato che dà contesto all'esito.
- Un identificativo per correlare con i tuoi log e la riconciliazione.
Input scadente, corrispondenza debole
L'accuratezza della corrispondenza dipende dalla qualità dell'input. Inviare nomi puliti e ben strutturati e il tipo di conto giusto migliora sensibilmente i risultati.
Progettare attorno al modello
L'API di Verification of Payee di RoxPay espone un modello chiaro di richiesta/risposta con esiti standardizzati e dettagli di supporto, così la tua integrazione può agire sui risultati con sicurezza.