Un exemple de Verification of Payee
À quoi ressemble réellement un contrôle VoP ? Voici un exemple concret : la requête que vous envoyez, la réponse JSON que vous recevez et l'apparence de chacun des quatre résultats.
À quoi ressemble un contrôle VoP en pratique
Un contrôle Verification of Payee est une question unique en temps réel : ce nom appartient-il à cet IBAN ? Vous soumettez le nom du bénéficiaire et l'IBAN, et la banque répondante renvoie un résultat normalisé avant l'autorisation du paiement.
Voici un exemple simplifié de requête et de réponse. Les noms exacts des champs dépendent du prestataire, mais chaque réponse VoP correspond aux quatre mêmes résultats du schéma.
Exemple de requête
POST /v1/verification-of-payee
Authorization: Bearer <token>
{
"payee": {
"name": "Maria Rossi",
"iban": "DE89370400440532013000"
}
}{
"outcome": "match",
"matchedName": "Maria Rossi",
"respondingBic": "COBADEFFXXX",
"requestId": "vop_8f3a2c91",
"processedAt": "2026-06-24T10:00:00Z"
}Les quatre résultats, avec exemples
Chaque réponse VoP se résume à l'un de ces quatre résultats.
match
Le nom correspond pleinement au titulaire — ex. vous avez envoyé 'Maria Rossi' et le compte est 'Maria Rossi'.
close match
Presque exact — ex. vous avez envoyé 'M. Rossi' et le titulaire est 'Maria Rossi'. Le nom vérifié est renvoyé en suggestion.
no match
Le nom ne correspond pas à l'IBAN — ex. 'Acme SAS' sur un compte détenu par 'Maria Rossi'. Un signal de fraude fort.
not possible
Le contrôle n'a pas pu aboutir — ex. la banque du bénéficiaire est injoignable ou l'IBAN n'est pas encore couvert.
Testez avec vos propres données
Le bac à sable RoxPay vous permet d'envoyer de vrais noms et IBAN et de voir exactement quel résultat revient — le moyen le plus rapide de comprendre la VoP avant l'intégration.
FAQ
C'est une petite réponse structurée contenant le résultat (correspondance, partielle, aucune ou impossible), et pour une correspondance partielle le nom vérifié en suggestion, ainsi que le BIC de la banque répondante et une référence de requête.
Envoyer 'M. Rossi' quand le titulaire est 'Maria Rossi' renvoie généralement une correspondance partielle, avec 'Maria Rossi' suggéré pour confirmer ou corriger le nom.
Au minimum le nom du bénéficiaire et l'IBAN. Pour les personnes morales, un identifiant d'organisation (numéro de TVA ou d'immatriculation) peut être ajouté pour améliorer la précision.
Oui. RoxPay fournit un bac à sable et la documentation API pour envoyer des requêtes d'exemple et inspecter la réponse de chaque résultat avant la mise en production.
Voyez l'API VoP en action
Obtenez l'accès au bac à sable et testez de vraies requêtes sur les quatre résultats.