Vérification du Bénéficiaire (VoP)

L'API Verification of Payee (VoP) permet d'intégrer la vérification préalable du bénéficiaire directement dans les systèmes de gestion, les plateformes e-commerce et les applications professionnelles. En envoyant une demande instantanée au PSP du destinataire, le service vérifie en temps réel la correspondance entre l'IBAN et le nom du titulaire saisis par le donneur d'ordre. Une solution essentielle pour bloquer les transactions non autorisées et protéger les opérations contre la fraude, le phishing et les rétrofacturations coûteuses.

VÉRIFICATION IBAN VOP

Pour effectuer la vérification, il est nécessaire d'envoyer une requête à l'endpoint  POST/iban-vop/{iban}. Le numéro IBAN peut être transmis indifféremment via l'endpoint ou dans le payload avec le nom. 

EXEMPLE DE REQUÊTE

POST/iban-vop/{iban}

Voici un exemple de requête pour vérifier un IBAN :

POST  https://trust.openapi.com/iban-vop/IT60X0542811101000000123456

Dans le Payload, il sera nécessaire de transmettre le nom (correctement renseigné) :

{
    "Name": "Mario Rossi"
}

Il est également possible de configurer une callback dans le Payload afin de recevoir une notification lorsque le résultat est disponible.

{
 "name": "Mario Openapi",
  "callback": {
    "method": "JSON",
    "field": "data",
    "url": "[https://your-server.site/iban-callback](https://your-server.site/iban-callback)",
    "headers": {
      "session\_id": "9834r5fh589494"
    }
    "custom": {
      "orderId": "iban-check-789"
    }
  }
}

EXEMPLE DE RÉPONSE

POST/iban-vop/{iban}

La réponse contient toujours l'ID de la requête. Si le PSP répond immédiatement, vous disposerez déjà du résultat. Dans le cas contraire, vous le recevrez via callback. 

{
  "success": true,
  "message": "Success",
  "error": null,
  "data": {
    "id": "69c117af962df6cee50c9525",
    "iban": "IT60X0306905020000000123456",
    "name": "Mario Rossi"
    "state": "DONE"
    "status": "Verification completed"
    "VopResult": "MATCH",
    "details":{
    "matchType": "MTCH",
    "ownerName": "Mario Rossi",
    "iban": "IT60X0306905020000000123456",
   },  
  "createdAt": "2026-08-10T12:43:45+00:00",
  "updatedAt": "2026-08-10T13:48:54+00:00"
}

La vérification peut produire 5 résultats possibles : 

RÉCUPÉRATION DU RÉSULTAT DE LA VÉRIFICATION

Si la réponse initiale n'est pas immédiatement disponible ou si vous souhaitez récupérer le résultat d'une vérification précédente, vous pouvez utiliser l'endpoint GET/iban-vop/{id}, en transmettant l'ID reçu lors de la requête précédente.

EXEMPLE DE REQUÊTE

GET/iban-vop/{id}

GEThttps://trust.openapi.com/iban-vop/69c117af962df6cee50c9525

EXEMPLE DE RÉPONSE

GET/iban-vop/{id}

La réponse aura la même structure que celle présentée ci-dessus :

{
  "success": true,
  "message": "Success",
  "error": null,
  "data": {
    "id": "69c117af962df6cee50c9525",
    "iban": "IT60X0306905020000000123456",
    "name": "Mario Rossi"
    "state": "DONE"
    "status": "Verification completed"
    "VopResult": "MATCH",
    "details":{
    "matchType": "MTCH",
    "ownerName": "Mario Rossi",
    "iban": "IT60X0306905020000000123456",
   },  
  "createdAt": "2026-08-10T12:43:45+00:00",
  "updatedAt": "2026-08-10T13:48:54+00:00"
}

À QUI S'ADRESSE LE SERVICE ?

Le service VoP (Verification of Payee) via API est conçu pour les entreprises et plateformes qui gèrent des paiements et des transferts d'argent et qui souhaitent vérifier en temps réel la correspondance entre le nom du bénéficiaire et l'IBAN avant d'autoriser une transaction. Il est particulièrement adapté aux fintechs, néobanques, plateformes de paiement et services de transfert d'argent, qui peuvent réduire le risque de paiements vers des comptes erronés ou frauduleux ; aux logiciels de comptabilité, ERP et systèmes de gestion financière, qui peuvent automatiser la vérification des IBAN lors de la saisie et de l'approbation des paiements ; aux marketplaces, plateformes de crowdfunding, plateformes de livraison et autres plateformes qui effectuent des paiements à des vendeurs et fournisseurs, afin de sécuriser les versements et de prévenir les fraudes liées à la modification des coordonnées bancaires ; ainsi qu'aux PSP, passerelles de paiement et plateformes de paiement B2B, qui peuvent intégrer la vérification du bénéficiaire directement dans leurs services et la proposer à leurs clients comme niveau supplémentaire de sécurité et de contrôle.