La Verification of Payee es conceptualmente simple: preguntas si un nombre coincide con un IBAN y recibes un resultado estandarizado. Pero una integración robusta depende de entender cada parte de ese intercambio y alimentarla con datos limpios.
El lado de la solicitud
- Nombre del beneficiario: el nombre como lo esperas, idealmente estructurado y limpio.
- IBAN: la cuenta que se verifica.
- Tipo de cuenta: si el beneficiario es una persona o una organización, lo que afecta a la coincidencia.
- Una referencia de solicitud o clave de idempotencia para vincular la llamada a tus registros.
El lado de la respuesta
- Resultado: coincidencia, coincidencia parcial, sin coincidencia o no disponible.
- Para una coincidencia parcial, el nombre realmente registrado, para que puedas mostrarlo al pagador.
- Un código de razón o estado que da contexto al resultado.
- Un identificador para correlacionar con tus logs y reconciliación.
Basura entra, coincidencia débil sale
La precisión de la coincidencia depende de la calidad de la entrada. Enviar nombres limpios y bien estructurados y el tipo de cuenta correcto mejora notablemente los resultados.
Diseñar en torno al modelo
La API de Verification of Payee de RoxPay expone un modelo claro de solicitud/respuesta con resultados estandarizados y detalles de apoyo, para que tu integración pueda actuar sobre los resultados con confianza.