La mayoría de las guías de integración VoP se detienen en «envía un nombre e IBAN, lee el resultado». La producción añade dos problemas: las redes fallan y los clientes reintentan, y más tarde finanzas pregunta «¿a qué pago pertenecía esta verificación?». Un solo campo — un external id estable por solicitud — resuelve ambos.
Idempotencia en los reintentos
Si una solicitud expira, tu cliente puede reintentarla. Sin una clave de idempotencia, eso es una segunda verificación — coste extra y registros confusos. Adjuntar el mismo external id al reintento permite al sistema reconocerlo como la misma solicitud lógica, así los reintentos son seguros.
Un id, generado una vez
Genera el external id cuando creas la intención de pago, no por intento HTTP. Así cada reintento de la misma verificación lógica lleva el mismo id.
Reconciliación
El mismo external id es tu clave de correlación. Almacénalo en tu registro de pago, envíalo con la verificación, y podrás luego unir el resultado de la verificación al pago exacto — esencial para disputas, auditorías y analítica.
Construye la pista de auditoría
- 1 Genera un external id por verificación y persístelo con tu pago.
- 2 Envíalo en la solicitud; reutilízalo en cualquier reintento.
- 3 Registra el id de verificación devuelto, el resultado y el BIC respondiente junto a él.
La API Verification of Payee de RoxPay acepta un external id por solicitud y devuelve su propio id de verificación con el BIC respondiente, así la idempotencia y la reconciliación surgen de un único patrón limpio.