CASO DE USO
Valida los destinatarios de pago antes de la transferencia
Un pago fallido en Latinoamerica no es solo un problema de experiencia de usuario. Genera comisiones bancarias, re-ingreso manual, ciclos de conciliacion y alertas de compliance. La mayoria de las fallas son prevenibles: el numero de cuenta tiene un error de checksum, el tax ID no coincide con el formato del pais, o se transpuso un digito. Normadata valida los datos del destinatario antes de que la instruccion de transferencia salga del sistema.
EL PROBLEMA
Los pagos fallidos son costosos de recuperar
Las estimaciones del sector para el reprocesamiento de pagos fallidos van de $5 a $25 por ocurrencia, contando comisiones de devolucion bancaria, intervencion manual y overhead de conciliacion. A escala, el costo se multiplica.
Formatos de cuenta especificos por pais
CBU (Argentina, 22 digitos con checksum), CLABE (Mexico, 18 digitos con verificacion tipo Luhn), IBAN (internacional, longitud variable). Cada formato tiene su propio algoritmo de validacion. Un regex no cubre el paso de checksum — una cadena de 22 digitos que falla la formula de pesos del CBU es estructuralmente incorrecta pero pasa una verificacion de longitud basica.
Desajuste de tax ID a nivel del destinatario
Algunos rails de transferencia requieren que el tax ID del destinatario coincida con el titular registrado de la cuenta. Un CUIT sintacticamente valido pero que referencia el tipo de contribuyente incorrecto (persona fisica vs. persona juridica) puede causar que la transferencia rebote del lado del banco.
Errores tipograficos detectados demasiado tarde
Un solo digito transpuesto en un CBU o CLABE es sintaticamente plausible pero invalido en checksum. Sin un gate de formato, ese error llega al procesador de pagos, dispara un rechazo y entra a una cola manual — horas o dias despues.
POR QUE LAS SOLUCIONES ESTANDAR NO ALCANZAN
Por que los equipos lo construyen internamente — y por que falla
Validadores con regex
El regex puede verificar la longitud y el conjunto de caracteres pero no puede verificar el digito de checksum. CBU y CLABE tienen un checksum ponderado. Un regex que aprueba un CBU malformado va a dejar pasar transferencias invalidas.
Librerias open source
La mayoria de los validadores de cuentas bancarias de LATAM en npm/PyPI cubren uno o dos paises y rara vez se actualizan cuando los bancos cambian codigos de ruteo o pesos del algoritmo. Mantener forks es trabajo operativo continuo.
Verificar despues de que la transferencia falla
Confiar en el procesador de pagos para detectar errores de formato significa que el error aparece despues de que el debito ya fue iniciado. En ese punto ya tenes comisiones, un trabajo fallido y trabajo manual de reintento.
COMO NORMADATA AYUDA
Como Normadata te ayuda
Valida el formato y checksum de CBU, CLABE e IBAN con una sola llamada API antes de construir la instruccion de transferencia. Normadata devuelve valid, normalized y el tipo de identificador — gate en valid=true antes de llamar a tu proveedor de pagos. Valida los tax IDs del destinatario (CUIT, RFC, CPF, CNPJ, RUT) en la misma llamada. Detecta desajustes de tipo de contribuyente (persona fisica vs. juridica) antes de que lleguen al banco. El campo checksum_valid distingue una cuenta bien formada de una con un digito transpuesto. Mostrá el error al usuario en el momento de ingreso, antes de que el registro se guarde. MIRALO EN ACCION
Miralo en accion
# Validate a batch of recipient accounts before initiating payouts
$ curl -X POST api.normadata.io/v1/validate/accounts \
-H "X-API-Key: nd_a8f3b2c1d4e5f6g7h8i9j0k1l2m3n4o5" \
-d '{"items":[
{"id":"1","country":"AR","type":"cbu","value":"0170099220000067802779"},
{"id":"2","country":"BR","type":"pix","value":"111.444.777-35"}
]}'
{
"results": [
{
"id": "1",
"country": "AR",
"type": "cbu",
"valid": true,
"checksum_valid": true,
"bank_name": "Galicia"
},
{
"id": "2",
"valid": true,
"checksum_valid": true
}
]
}
# Same endpoint for 1 or N (up to 1,000 per request)
# Each result carries the id you sent — correlate by it, then release the payout
LIMITACIONES
Que no hace Normadata aqui
—Normadata no verifica que la cuenta bancaria exista realmente o pertenezca al destinatario nombrado. Validez de formato no es verificacion de titularidad de cuenta.
—Normadata no se integra con BCRA, Banxico ni ningun API de banco central. Solo valida formato y checksum.
PREGUNTAS FRECUENTES
Preguntas frecuentes
Puede Normadata confirmar que un CBU pertenece a una persona especifica?
No. Normadata valida que el CBU sea estructuralmente correcto (22 digitos, checksum valido). No consulta el BCRA ni ningun sistema bancario para confirmar titularidad o estado de la cuenta.
Normadata soporta validacion de CLABE?
Si. Normadata valida CLABE (Mexico, 18 digitos) incluyendo el digito de checksum ponderado. Pasa country=MX, type=clabe al endpoint validate.
Integra Normadata en tu stack
El acceso se otorga manualmente. Unite a la lista de espera y te damos acceso a la API.