Construire la Verification of Payee de zéro signifie s'intégrer à chaque PSP répondant et normaliser chaque réponse. Une API VoP supprime ce travail : vous vous connectez une fois, et le prestataire gère la connectivité au schéma sur tout le SEPA. Votre tâche devient une intégration requête/réponse propre.
1. Authentifiez-vous
Les appels se font en HTTPS et sont authentifiés par un bearer token. Stockez l'identifiant comme un secret, jamais côté client. Pour des vérifications manuelles ou à faible volume, un tableau de bord est disponible afin que les non-développeurs puissent vérifier sans écrire de code.
2. Envoyez la requête
Envoyez en POST le nom et l'IBAN du bénéficiaire à l'endpoint de vérification. Incluez votre propre identifiant de référence afin de réconcilier le résultat avec le paiement ou l'enregistrement d'onboarding auquel il appartient.
Gardez-la idempotente
Passez un identifiant externe stable à chaque requête afin que les réessais ne créent pas de vérifications en double, et que vous puissiez relier une entrée de journal asynchrone à l'action d'origine.
3. Gérez les quatre résultats
Chaque réponse correspond à un code du schéma SEPA, votre branchement reste donc simple :
- MATCH (MTCH) — le nom correspond au titulaire du compte ; poursuivez en confiance.
- CLOSE_MATCH (CMTC) — presque juste ; affichez le nom vérifié suggéré et demandez à l'utilisateur de confirmer.
- NO_MATCH (NMTC) — affichez un avertissement clair avant la confirmation du paiement.
- NOT_APPLICABLE (NOAP) — vérification indisponible pour l'instant ; laissez l'utilisateur décider.
La réponse contient aussi le BIC de la banque répondante et le temps de traitement, utiles pour la supervision et les journaux d'audit.
4. Réutilisez-la partout
Comme le contrat est le même, l'unique endpoint sert plusieurs usages : une vérification en ligne lorsqu'un payeur examine un nouveau bénéficiaire, la vérification par lots d'un fichier fournisseurs et un pré-contrôle dans un flux de mandat SEPA Direct Debit. RoxPay utilise la VoP exactement ainsi — y compris comme pré-contrôle obligatoire avant l'émission d'un lien de signature de mandat SDD.