L'API Verification of Payee
Un appel REST en temps réel pour confirmer le nom d'un bénéficiaire par rapport à un IBAN — résultat, BIC de la banque répondante et temps de traitement dans la réponse. Conçue sur la plateforme RoxPay et le schéma SEPA VoP.
{ "Name": "ACME Trading Ltd", "Iban": "DE89 3704 0044 0532 0130 00" }
{ "VopResult": "MATCH", "MatchType": "MTCH", "RespondingBic": "CRACIT33XXX" }
La vérification du bénéficiaire en une seule requête
L'API Verification of Payee expose le schéma SEPA VoP comme un endpoint REST propre : envoyez un nom et un IBAN, recevez un résultat standardisé en temps réel — sans avoir à construire vous-même la tuyauterie du schéma.
C'est la même vérification que RoxPay exécute dans sa plateforme bancaire SwiftLine / RoxBusiness, disponible pour les banques, PSP et entreprises via une API authentifiée et un tableau de bord. Chaque réponse inclut le type de correspondance, le BIC de l'institution répondante et le temps de traitement du PSP.
Comme elle est fournie via l'infrastructure d'open banking européenne de RoxPay, vous vous connectez une fois et atteignez la vérification du bénéficiaire sur tout l'espace SEPA — au lieu de vous intégrer à chaque banque répondante.
De zéro à vérifié en quatre étapes
Une intégration REST standard qui s'insère dans votre flux de paiement existant.
Obtenez vos identifiants
Activez le service et authentifiez-vous avec un bearer token — aucun onboarding banque par banque à gérer.
Envoyez nom + IBAN
Envoyez en POST le nom et l'IBAN du bénéficiaire à l'endpoint de vérification, avec un id de référence optionnel pour le rapprochement.
Lisez le résultat
Recevez le résultat (correspondance / proche / aucune / non applicable), le BIC répondant et le temps de traitement.
Agissez dans votre UI
Affichez un signal clair au payeur, ou conditionnez au résultat une remise, un mandat ou une étape d'onboarding.
Ce que l'API renvoie
Chaque réponse correspond à un code du schéma SEPA VoP, votre logique reste donc simple.
MATCH · MTCH
Le nom correspond au titulaire du compte. La réponse contient aussi le BIC de la banque répondante.
CLOSE_MATCH · CMTC
Correspondance proche — traitez-la comme un avertissement et suggérez le nom vérifié.
NO_MATCH · NMTC
Le nom ne correspond pas. Affichez un avertissement clair avant la confirmation du paiement.
NOT_APPLICABLE · NOAP
Vérification non disponible pour cet IBAN actuellement. Laissez l'utilisateur décider.
Construire la VoP soi-même vs. l'API
Ce que vous évitez en appelant un endpoint plutôt qu'en rejoignant le schéma seul.
Développement interne
- Connectivité au schéma Intégration par PSP répondant
- Délai de mise en production Mois
- Détail de la réponse Vous la normalisez
- Réutilisation entre produits À recâbler pour chaque flux
- Maintenance À votre charge
API Verification of Payee
- Connectivité au schéma Une connexion, portée SEPA
- Délai de mise en production Semaines
- Détail de la réponse Résultat standardisé + BIC + temps
- Réutilisation entre produits Une API pour UI, lot et mandats
- Maintenance Gérée par la plateforme
Une API, trois publics
Le même endpoint répond à des besoins très différents.
Banques et PSP
Offrez la Verification of Payee aux titulaires de comptes et respectez le Règlement sur les paiements instantanés sans construire la connectivité au schéma.
Développeurs
Un contrat REST prévisible, des réponses en temps réel, vos propres id de référence et des codes de schéma clairs sur lesquels brancher.
Entreprises et ERP
Vérifiez en masse les IBAN des fournisseurs et de la paie avant une remise, réduisant le risque de détournement de factures.
L'API, en réponses
Les premières questions des développeurs et équipes produit.
Oui. Un appel de vérification répond de manière synchrone, généralement en bien moins d'une seconde, et inclut le BIC de la banque répondante et le temps de traitement du PSP pour surveiller les performances.
Les appels sont authentifiés avec un bearer token sur HTTPS. Vous pouvez aussi utiliser le tableau de bord RoxBusiness pour des contrôles ponctuels sans écrire de code.
Un résultat normalisé (MATCH, CLOSE_MATCH, NO_MATCH, NOT_APPLICABLE), le code de type de correspondance du schéma SEPA, un id de vérification, le BIC répondant, le temps de traitement et votre id externe optionnel.
Oui — appelez l'endpoint par enregistrement pour vérifier un fichier entier de fournisseurs ou bénéficiaires avant une remise. Elle est conçue pour de gros volumes.
Oui. Le contrôle compare le nom soumis au titulaire du compte enregistré, qu'il s'agisse d'une personne physique ou d'une entreprise, et est utilisé dans le flux des mandats SEPA Direct Debit de RoxPay comme pré-contrôle.
NO_MATCH n'est pas une erreur de transport — c'est une réponse 200 valide indiquant que le nom n'appartient pas à l'IBAN. Traitez-la comme un arrêt net dans votre UI ou votre remise : affichez un avertissement clair, bloquez l'approbation automatique et faites revérifier le bénéficiaire avant l'envoi.
CLOSE_MATCH (code de schéma CMTC) signifie que le nom est presque exact — un deuxième prénom manquant, une raison sociale vs un nom commercial. La réponse contient le nom vérifié du titulaire, vous pouvez donc l'afficher comme suggestion et demander confirmation au payeur plutôt que de rejeter le paiement.
Pour les personnes morales, le schéma permet la vérification par rapport à l'identifiant de l'organisation ainsi qu'au nom. Vous soumettez l'identifiant dans la requête et l'API renvoie le résultat standard — utile lorsque la raison sociale et le nom commercial diffèrent.
Oui. Pour une remise, parcourez votre fichier de fournisseurs ou de paie et appelez l'endpoint de vérification par enregistrement avant de libérer le lot. Conçue pour de gros volumes, elle permet aux équipes financières de valider en masse les IBAN par rapport aux noms avant chaque remise.
Intégrez la Verification of Payee
Obtenez vos identifiants et passez en production sur le schéma SEPA VoP avec une seule intégration REST.