La plupart des guides d'intégration VoP s'arrêtent à « envoyez un nom et un IBAN, lisez le résultat ». La production ajoute deux problèmes : les réseaux échouent et les clients réessaient, et plus tard la finance demande « à quel paiement appartenait cette vérification ? ». Un seul champ — un external id stable par requête — résout les deux.
Idempotence sur les retries
Si une requête expire, votre client peut la réessayer. Sans clé d'idempotence, c'est une seconde vérification — coût supplémentaire et journaux confus. Attacher le même external id au retry permet au système de le reconnaître comme la même requête logique, donc les retries sont sûrs.
Un id, généré une fois
Générez l'external id quand vous créez l'intention de paiement, pas par tentative HTTP. Ainsi chaque retry de la même vérification logique porte le même id.
Réconciliation
Le même external id est votre clé de corrélation. Stockez-le sur votre enregistrement de paiement, envoyez-le avec la vérification, et vous pourrez plus tard joindre le résultat de la vérification au paiement exact — essentiel pour les litiges, les audits et l'analytique.
Bâtir la piste d'audit
- 1 Générez un external id par vérification et persistez-le avec votre paiement.
- 2 Envoyez-le sur la requête ; réutilisez-le sur tout retry.
- 3 Journalisez l'id de vérification renvoyé, le résultat et le BIC répondant en regard.
L'API Verification of Payee de RoxPay accepte un external id par requête et renvoie son propre id de vérification avec le BIC répondant, de sorte que l'idempotence et la réconciliation découlent d'un seul schéma propre.