Construir la Verification of Payee desde cero implica integrarse con cada PSP respondedor y normalizar cada respuesta. Una API VoP elimina ese trabajo: te conectas una vez y el proveedor gestiona la conectividad al esquema en toda la SEPA. Tu tarea se convierte en una integración limpia de solicitud/respuesta.
1. Autentícate
Las llamadas se hacen por HTTPS y se autentican con un bearer token. Guarda la credencial como secreto, nunca en el cliente. Para comprobaciones manuales o de bajo volumen hay un panel disponible, para que quienes no programan puedan verificar sin escribir código.
2. Envía la solicitud
Envía por POST el nombre y el IBAN del beneficiario al endpoint de verificación. Incluye tu propio id de referencia para conciliar el resultado con el pago o el registro de onboarding al que pertenece.
Mantenla idempotente
Pasa un id externo estable en cada solicitud para que los reintentos no creen verificaciones duplicadas y puedas vincular una entrada de log asíncrona con la acción de origen.
3. Gestiona los cuatro resultados
Cada respuesta corresponde a un código del esquema SEPA, así que tu ramificación se mantiene simple:
- MATCH (MTCH) — el nombre coincide con el titular de la cuenta; continúa con confianza.
- CLOSE_MATCH (CMTC) — casi correcto; muestra el nombre verificado sugerido y pide al usuario que confirme.
- NO_MATCH (NMTC) — muestra un aviso claro antes de confirmar el pago.
- NOT_APPLICABLE (NOAP) — verificación no disponible ahora; deja decidir al usuario.
La respuesta también lleva el BIC del banco respondedor y el tiempo de procesamiento, útiles para la monitorización y los logs de auditoría.
4. Reutilízala en todas partes
Como el contrato es el mismo, el único endpoint sirve para varios fines: una comprobación en línea mientras un pagador revisa un nuevo beneficiario, la verificación por lotes de un fichero de proveedores y una pre-comprobación dentro de un flujo de mandato SEPA Direct Debit. RoxPay usa la VoP exactamente así — incluso como pre-comprobación obligatoria antes de emitir el enlace de firma de un mandato SDD.