Comment intégrer RoxPay Verification of Payee

À retenir

Commencez dans le sandbox avec des clés de test avant de toucher à la production.
Appelez un seul endpoint avec le nom du bénéficiaire et l'IBAN, puis gérez quatre résultats.
Mappez correspondance, correspondance partielle, absence de correspondance et impossible dans votre UX payeur.

La Verification of Payee (VoP) vérifie que le nom sur un paiement correspond au titulaire du compte derrière l'IBAN avant que l'argent ne bouge. Sous le règlement européen sur les paiements instantanés, elle est obligatoire pour les virements en euros, mais l'intégration elle-même n'a pas à être complexe. Avec RoxPay, cela se résume à une poignée d'étapes.

1. Obtenez des identifiants sandbox

Commencez par demander des clés API sandbox. Le sandbox reproduit le comportement de production avec des données de test, pour construire et vérifier votre flux sans toucher à des comptes réels ou de vrais clients.

2. Appelez l'endpoint de vérification

Envoyez le nom du bénéficiaire et l'IBAN à un seul endpoint. RoxPay achemine la vérification vers le bon schéma et la bonne banque, normalise la réponse et renvoie un résultat clair — vous ne gérez pas vous-même les connexions bancaires individuelles.

Un endpoint, couverture complète

Au lieu d'intégrer chaque banque ou schéma séparément, vous appelez un seul endpoint RoxPay et obtenez des résultats normalisés sur les comptes joignables en SEPA.

3. Gérez les quatre résultats

Correspondance : le nom et le titulaire concordent — laissez le paiement se poursuivre.
Correspondance partielle : presque exact (ex. abréviation) — affichez le nom suggéré et laissez le payeur confirmer.
Absence de correspondance : les noms diffèrent — avertissez le payeur avant qu'il ne continue.
Vérification impossible : la banque n'a pas pu répondre — expliquez et laissez le payeur décider.

4. Concevez l'expérience du payeur

L'appel technique n'est que la moitié du travail. Mappez chaque résultat dans une UI claire et non alarmante pour que les payeurs sachent quoi faire. Une correspondance partielle devrait suggérer le nom vérifié ; une absence de correspondance devrait avertir sans bloquer purement les paiements légitimes.

5. Passez en production

Une fois que votre flux gère chaque résultat et que vous avez testé en charge face à des pics réalistes, remplacez les clés sandbox par des clés de production. Le monitoring et la journalisation de RoxPay vous aident à surveiller l'intégration dans les jours suivant la mise en production.

Tous les articles

FAQ

Questions fréquentes

Combien de temps prend une intégration VoP RoxPay ?

Comme vous appelez un seul endpoint et que RoxPay gère la connectivité aux banques et aux schémas, la plupart des équipes construisent et testent le flux principal en jours plutôt qu'en mois. Le gros du travail est de concevoir l'expérience du payeur pour chaque résultat.

Dois-je me connecter à chaque banque ?

Non. Vous intégrez une fois avec RoxPay, qui achemine les vérifications sur les comptes joignables en SEPA et renvoie des résultats normalisés, sans que vous mainteniez des connexions bancaires individuelles.

Puis-je tester sans comptes réels ?

Oui. Le sandbox utilise des données de test qui reproduisent le comportement de production, pour construire et valider chaque résultat avant la mise en production.

Continuer la lecture

Guide d'intégration de l'API VoP Le détail technique derrière l'appel. Comprendre les quatre résultats Correspondance, partielle, absence, impossible.