Verifica del Beneficiario (VoP)

L'API Verification of Payee (VoP) permette di integrare la verifica preventiva del beneficiario direttamente all'interno di sistemi gestionali, piattaforme e-commerce e app aziendali. Inviando una richiesta istantanea al PSP del destinatario, il servizio accerta in tempo reale la corrispondenza tra l'IBAN e il nome dell'intestatario inseriti dall'ordinante. Una soluzione chiave per bloccare transazioni non autorizzate e proteggere l'operatività da frodi, phishing e costosi storni.

VERIFICA IBAN VOP

Per effettuare la verifica è necessario inviare una richiesta all'endpoint  POST/iban-vop/{iban}. Il numero IBAN è possibile passarlo indifferentemente tramite endpoint o nel payload insieme al nome. 

ESEMPIO RICHIESTA

POST/iban-vop/{iban}

Questo è un esempio di richiesta per verificare un IBAN:

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

Nel Payload sarà necessario passare il nome (correttamente compilato):

{
    "Name": "Mario Rossi"
}

Nel Payload è possibile inoltre impostare una callback per ricevere una notifica quando il risultato sarà disponibile.

{
 "name": "Mario Openapi",
  "callback": {
    "method": "JSON",
    "field": "data",
    "url": "https://your-server.site/iban-callback",
    "headers": {
      "session_id": "9834r5fh589494"
    }
    "custom": {
      "orderId": "iban-check-789"
    }
  }
}

ESEMPIO RISPOSTA

POST/iban-vop/{iban}

La risposta contiene sempre l'ID della richiesta. Se il PSP risponde immediatamente, avrai già il risultato. Altrimenti, lo riceverai 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 verifica può presentare 5 possibili risultati: 

Recupero risultato della verifica

Se la risposta iniziale non è immediatamente disponibile o si vuole recuperare il risultato di una precedente verifica è possibile utilizzare l’endpoint GET/iban-vop/{id}, passando l’ID ricevuto nella richiesta precedente.

ESEMPIO RICHIESTA

GET/iban-vop/{id}

GET https://trust.openapi.com/iban-vop/69c117af962df6cee50c9525

ESEMPIO RISPOSTA

GET/iban-vop/{id}

La risposta avrà la stessa struttura di cui sopra:

{
  "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"
}

A CHI È RIVOLTO

Il servizio VoP (Verification of Payee) tramite API è pensato per aziende e piattaforme che gestiscono pagamenti e trasferimenti di denaro e vogliono verificare in tempo reale la corrispondenza tra il nome del beneficiario e l’IBAN prima di autorizzare una transazione. È particolarmente adatto a fintech, neobank, piattaforme di pagamento e money transfer, che possono ridurre il rischio di pagamenti verso conti errati o fraudolenti; software di contabilità, ERP e sistemi di gestione finanziaria, che possono automatizzare la verifica degli IBAN durante l’inserimento e l’approvazione dei pagamenti; marketplace, piattaforme di crowdfunding, delivery e altre piattaforme che effettuano pagamenti verso seller e fornitori, per proteggere gli accrediti e prevenire frodi legate alla modifica delle coordinate bancarie; e PSP, payment gateway e piattaforme B2B di pagamento, che possono integrare la verifica del beneficiario direttamente nei propri servizi e offrirla ai propri clienti come ulteriore livello di sicurezza e controllo.