Un ejemplo de Verification of Payee
¿Cómo es realmente una comprobación VoP? Aquí tienes un ejemplo concreto: la solicitud que envías, la respuesta JSON que recibes y cómo aparece cada uno de los cuatro resultados.
Cómo es una comprobación VoP en la práctica
Una comprobación Verification of Payee es una única pregunta en tiempo real: ¿este nombre pertenece a este IBAN? Envías el nombre del beneficiario y el IBAN, y el banco respondedor devuelve un resultado estandarizado antes de autorizar el pago.
A continuación, un ejemplo simplificado de solicitud y respuesta. Los nombres exactos de los campos dependen del proveedor, pero cada respuesta VoP se corresponde con los mismos cuatro resultados del esquema.
Ejemplo de solicitud
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"
}Los cuatro resultados, con ejemplos
Cada respuesta VoP se reduce a uno de estos cuatro resultados.
match
El nombre coincide plenamente con el titular — p. ej. enviaste 'Maria Rossi' y la cuenta es 'Maria Rossi'.
close match
Casi correcto — p. ej. enviaste 'M. Rossi' y el titular es 'Maria Rossi'. Se devuelve el nombre verificado como sugerencia.
no match
El nombre no coincide con el IBAN — p. ej. 'Acme SL' en una cuenta de 'Maria Rossi'. Una fuerte señal de fraude.
not possible
La comprobación no pudo completarse — p. ej. el banco del beneficiario no está disponible o el IBAN aún no tiene cobertura.
Pruébalo con tus propios datos
El entorno de pruebas de RoxPay te permite enviar nombres e IBAN reales y ver exactamente qué resultado vuelve — la forma más rápida de entender la VoP antes de integrarla.
FAQ
Es una pequeña respuesta estructurada con el resultado (coincidencia, parcial, ninguna o no posible) y, para una coincidencia parcial, el nombre verificado como sugerencia, además del BIC del banco respondedor y una referencia de la solicitud.
Enviar 'M. Rossi' cuando el titular es 'Maria Rossi' suele devolver una coincidencia parcial, con 'Maria Rossi' sugerido para que el pagador confirme o corrija el nombre.
Como mínimo el nombre del beneficiario y el IBAN. Para personas jurídicas se puede incluir un identificador de la organización (como NIF o número de registro) para mejorar la precisión.
Sí. RoxPay ofrece un entorno de pruebas y documentación de API para enviar solicitudes de ejemplo e inspeccionar la respuesta de cada resultado antes de pasar a producción.
Ve la API VoP en acción
Consigue acceso al entorno de pruebas y prueba solicitudes reales con los cuatro resultados.