Verification of Payee: guías para desarrolladores
Guías técnicas para integrar la Verification of Payee — la API y los códigos de respuesta, los webhooks, latencia, idempotencia, reintentos, límites de tasa y coincidencia de nombre.
27 artículos en este tema
Monitorización y observabilidad de la Verification of Payee
Una integración VoP puede fallar en silencio: latencia creciente, un desplazamiento en los resultados, una tasa de error que se cuela. Una buena observabilidad lo detecta antes de que los pagadores lo sientan.
Límites de tasa y throughput de la Verification of Payee
Un ciclo de pago que verifica miles de beneficiarios necesita un plan para los límites de tasa y el throughput. Esto es cómo escalar la Verification of Payee sin toparse con un muro.
La Verification of Payee y la residencia de datos
La verificación del beneficiario maneja datos personales sobre las personas que se pagan. Dónde se procesan y almacenan esos datos importa para el RGPD — y para tu due diligence.
Pruebas de carga de tu integración Verification of Payee
Tu integración VoP necesita aguantar en el pico, no solo en una demo. Esto es cómo hacerle pruebas de carga antes del go-live, qué medir y cómo usar el sandbox.
¿Qué es un RVM (Routing and Verification Mechanism)?
Ningún banco se conecta bilateralmente con todos los demás PSP de la SEPA. Un RVM es el servicio que enruta tu solicitud VoP al banco respondiente correcto — la fontanería que hace alcanzable el esquema.
Verification of Payee: manejo de errores y UX de respaldo
No toda comprobación VoP devuelve una coincidencia limpia. Esto es cómo diseñar manejo de errores y UX de respaldo para timeouts y «no disponible» sin bloquear ni engañar a los usuarios.
El EPC Directory Service (EDS) explicado
Antes de poder enrutar una solicitud VoP, algo tiene que indicar qué banco mantiene la cuenta y qué RVM la sirve. Ese algo es el EPC Directory Service — la agenda del esquema.
Entender el modelo de datos de la Verification of Payee
Una integración limpia empieza por entender qué envías y qué recibes. Esto es el modelo de datos de solicitud y respuesta de la Verification of Payee, explicado.
Certificados QWAC y eIDAS para la Verification of Payee
Cuando un banco pregunta a otro por un titular de cuenta, ambos deben probar quiénes son. La VoP lo hace con certificados QWAC bajo eIDAS — el mismo modelo de confianza que el open banking PSD2.
Usar un SDK o biblioteca cliente de Verification of Payee
Un buen SDK transforma la integración VoP de boilerplate en unas pocas líneas de código. Esto es qué buscar en una biblioteca cliente de Verification of Payee.
Proteger la API de Verification of Payee: mTLS, OAuth y claves
Las solicitudes VoP transportan nombres e IBAN, así que la seguridad del transporte y del acceso es esencial. Esto es cómo mTLS, OAuth y una buena higiene de claves protegen tu integración.
Verification of Payee: llamadas API por lotes vs individuales
Algunos casos de uso VoP necesitan una comprobación individual instantánea; otros verifican miles de cuentas a la vez. Esto es cómo elegir entre verificación en tiempo real y por lotes.
Cachear los resultados de la Verification of Payee de forma segura
Cachear los resultados VoP puede reducir coste y latencia — pero un resultado obsoleto puede dejar pasar un fraude. Esto es cómo cachear la verificación del beneficiario sin perder su valor protector.
La Verification of Payee y la mensajería ISO 20022
La mensajería del esquema VoP se basa en ISO 20022, pero tu integración no. Esto es cómo se relaciona la norma con la VoP y dónde encaja una API REST.
Registro de auditoría para la Verification of Payee
Un resultado de Verification of Payee solo es útil después si lo registraste bien. Esto es qué anotar para cada comprobación, cuánto conservarlo y qué dejar fuera.
Gestionar timeouts y reintentos en la Verification of Payee
Un PSP lento debería degradar tu checkout con elegancia, no romperlo. Esto es un patrón práctico para timeouts, reintentos y el resultado no disponible en la Verification of Payee.
Cómo probar la Verification of Payee en un sandbox
No puedes probar la VoP correctamente comprobando solo el camino feliz. Esto es cómo ejercitar cada resultado — coincidencia, parcial, sin coincidencia, no aplicable — y los caminos de error antes del go-live.
Webhooks y resultados asíncronos de la Verification of Payee
La mayoría de las comprobaciones VoP responden en menos de un segundo, pero las redes fallan y algunos bancos respondedores son lentos. Los webhooks permiten gestionar los resultados asíncronos limpiamente sin bloquear al pagador.
Idempotencia y reconciliación en la API Verification of Payee
Los reintentos ocurren. Sin idempotencia cuentas las comprobaciones por duplicado; sin un correlation id no puedes vincular los resultados a los pagos. Esto es cómo lograr ambos con un solo campo.
Verificar empresas: personas jurídicas e identificadores de organización en la VoP
Los nombres de empresa son caóticos — nombres comerciales, sufijos, abreviaturas. Por eso la Verification of Payee permite verificar las personas jurídicas por un identificador de organización, no solo por un nombre.
Cómo funciona la coincidencia de nombre en la Verification of Payee
La VoP no hace comparación de cadena exacta — si lo hiciera, cada inicial y acento sería una sin coincidencia. Esto es lo que realmente ocurre entre el nombre que envías y el resultado que obtienes.
¿Qué tan rápida es la Verification of Payee? Latencia y timeouts
La VoP se ejecuta en el momento del pago, así que la velocidad importa. Esto es qué latencia esperar, qué pasa en un timeout y cómo mantener la experiencia ágil.
Reducir falsos positivos en Verification of Payee
Si cada pago devuelve una coincidencia parcial, los usuarios dejan de confiar en el aviso. Así reduces los falsos positivos en la VoP sin debilitar la verdadera señal de fraude.
Una conexión VoP vs integrar banco por banco
Podrías integrar cada banco respondedor tú mismo. O conectarte una vez al esquema SEPA VoP y alcanzarlos a todos. Esto es por qué la cobertura, no el código, es el verdadero reto.
Códigos de respuesta y error de la API Verification of Payee, explicados
MTCH, CMTC, NMTC, NOAP — y la diferencia entre un resultado «sin coincidencia» y un error real. Una referencia para desarrolladores para gestionar limpiamente las respuestas de la API VoP.
Ser un PSP respondedor en el esquema Verification of Payee
La mayoría del contenido VoP cubre el lado solicitante — preguntar «¿este nombre coincide con este IBAN?». Pero el cumplimiento a menudo significa también responder a esas solicitudes. Esto es lo que un PSP respondedor debe hacer.
Integrar la API Verification of Payee: guía para desarrolladores
De la autenticación a la gestión de los cuatro resultados del esquema, así se integra una API Verification of Payee en tiempo real y se ramifica la interfaz con limpieza.
¿Listo para añadir la Verification of Payee?
Del esquema EPC a una sola llamada REST, RoxPay ayuda a bancos, PSP y empresas a entrar en producción con la VoP antes de su plazo.