La Verification of Payee est conceptuellement simple : vous demandez si un nom correspond à un IBAN, et vous recevez un résultat standardisé. Mais une intégration robuste dépend de la compréhension de chaque partie de cet échange et de son alimentation en données propres.
Le côté requête
- Nom du bénéficiaire : le nom tel que vous l'attendez, idéalement structuré et propre.
- IBAN : le compte vérifié.
- Type de compte : si le bénéficiaire est une personne ou une organisation, ce qui affecte la correspondance.
- Une référence de requête ou clé d'idempotence pour lier l'appel à vos enregistrements.
Le côté réponse
- Résultat : correspondance, correspondance partielle, absence de correspondance ou non disponible.
- Pour une correspondance partielle, le nom réellement détenu, pour que vous puissiez le montrer au payeur.
- Un code de raison ou de statut donnant du contexte au résultat.
- Un identifiant pour corréler avec vos journaux et votre réconciliation.
Données médiocres en entrée, correspondance faible en sortie
La précision de la correspondance dépend de la qualité de l'entrée. Envoyer des noms propres et bien structurés et le bon type de compte améliore sensiblement les résultats.
Concevoir autour du modèle
L'API Verification of Payee de RoxPay expose un modèle requête/réponse clair avec des résultats standardisés et des détails de support, pour que votre intégration puisse agir sur les résultats avec confiance.