La API Verification of Payee
Una llamada REST en tiempo real para confirmar el nombre de un beneficiario frente a un IBAN — resultado, BIC del banco respondedor y tiempo de procesamiento en la respuesta. Construida sobre la plataforma RoxPay y el esquema SEPA VoP.
{ "Name": "ACME Trading Ltd", "Iban": "DE89 3704 0044 0532 0130 00" }
{ "VopResult": "MATCH", "MatchType": "MTCH", "RespondingBic": "CRACIT33XXX" }
La verificación del beneficiario en una sola solicitud
La API Verification of Payee expone el esquema SEPA VoP como un endpoint REST limpio: envíe un nombre y un IBAN, reciba un resultado estandarizado en tiempo real — sin tener que construir usted mismo la fontanería del esquema.
Es la misma verificación que RoxPay ejecuta dentro de su plataforma bancaria SwiftLine / RoxBusiness, disponible para bancos, PSP y empresas mediante una API autenticada y un panel. Cada respuesta incluye el tipo de coincidencia, el BIC de la institución respondedora y el tiempo de procesamiento del PSP.
Como se entrega sobre la infraestructura europea de open banking de RoxPay, se conecta una vez y alcanza la verificación del beneficiario en toda SEPA — en lugar de integrarse con cada banco respondedor.
De cero a verificado en cuatro pasos
Una integración REST estándar que encaja en su flujo de pago existente.
Obtenga sus credenciales
Active el servicio y autentíquese con un bearer token — sin onboarding banco por banco que gestionar.
Envíe nombre + IBAN
Envíe por POST el nombre y el IBAN del beneficiario al endpoint de verificación, con un id de referencia opcional para la conciliación.
Lea el resultado
Reciba el resultado (coincidencia / parcial / ninguna / no aplicable), el BIC respondedor y el tiempo de procesamiento.
Actúe en su UI
Muestre una señal clara al pagador, o condicione al resultado una remesa, un mandato o un paso de onboarding.
Qué devuelve la API
Cada respuesta corresponde a un código del esquema SEPA VoP, así su lógica se mantiene simple.
MATCH · MTCH
El nombre coincide con el titular de la cuenta. La respuesta también lleva el BIC del banco respondedor.
CLOSE_MATCH · CMTC
Coincidencia parcial — trátela como una advertencia y sugiera el nombre verificado.
NO_MATCH · NMTC
El nombre no coincide. Muestre una advertencia clara antes de confirmar el pago.
NOT_APPLICABLE · NOAP
Verificación no disponible para este IBAN ahora. Deje decidir al usuario.
Construir la VoP usted mismo vs. la API
Lo que evita llamando a un endpoint en lugar de unirse al esquema en solitario.
Desarrollo interno
- Conectividad al esquema Integración por PSP respondedor
- Tiempo de puesta en marcha Meses
- Detalle de la respuesta Usted la normaliza
- Reutilización entre productos Recablear cada flujo
- Mantenimiento A su cargo
API Verification of Payee
- Conectividad al esquema Una conexión, alcance SEPA
- Tiempo de puesta en marcha Semanas
- Detalle de la respuesta Resultado estandarizado + BIC + tiempos
- Reutilización entre productos Una API para UI, lote y mandatos
- Mantenimiento Gestionado por la plataforma
Una API, tres públicos
El mismo endpoint resuelve necesidades muy distintas.
Bancos y PSP
Ofrezca la Verification of Payee a los titulares de cuentas y cumpla el Reglamento de Pagos Instantáneos sin construir la conectividad al esquema.
Desarrolladores
Un contrato REST predecible, respuestas en tiempo real, sus propios id de referencia y códigos de esquema claros para ramificar.
Empresas y ERP
Verifique en masa los IBAN de proveedores y nóminas antes de una remesa, reduciendo el riesgo de desvío de facturas.
La API, respondida
Las primeras preguntas de desarrolladores y equipos de producto.
Sí. Una llamada de verificación responde de forma síncrona, normalmente en mucho menos de un segundo, e incluye el BIC del banco respondedor y el tiempo de procesamiento del PSP para monitorizar el rendimiento.
Las llamadas se autentican con un bearer token sobre HTTPS. También puede usar el panel RoxBusiness para comprobaciones puntuales sin escribir código.
Un resultado normalizado (MATCH, CLOSE_MATCH, NO_MATCH, NOT_APPLICABLE), el código de tipo de coincidencia del esquema SEPA, un id de verificación, el BIC respondedor, el tiempo de procesamiento y su id externo opcional.
Sí — llame al endpoint por registro para verificar un fichero entero de proveedores o beneficiarios antes de una remesa. Está construida para alto rendimiento.
Sí. El control compara el nombre enviado con el titular de la cuenta registrado, ya sea una persona física o una empresa, y se usa en el flujo de mandatos SEPA Direct Debit de RoxPay como comprobación previa.
NO_MATCH no es un error de transporte — es una respuesta 200 válida que indica que el nombre no pertenece al IBAN. Trátela como una parada en firme en su UI o remesa: muestre una advertencia clara, bloquee la aprobación automática y haga revisar el beneficiario antes de enviar.
CLOSE_MATCH (código de esquema CMTC) significa que el nombre es casi correcto — falta un segundo nombre, una razón social vs un nombre comercial. La respuesta lleva el nombre verificado del titular, así que puede mostrarlo como sugerencia y pedir confirmación al pagador en lugar de rechazar el pago.
Para personas jurídicas el esquema permite la verificación frente al identificador de la organización además del nombre. Envía el identificador en la solicitud y la API devuelve el resultado estándar — útil cuando la razón social y el nombre comercial difieren.
Sí. Para una remesa, recorra su fichero de proveedores o nóminas y llame al endpoint de verificación por registro antes de liberar el lote. Construida para alto rendimiento, permite a los equipos financieros validar en masa los IBAN frente a los nombres antes de cada remesa.
Integre la Verification of Payee
Obtenga sus credenciales y salga en producción sobre el esquema SEPA VoP con una sola integración REST.