`ValidateAccountResponse`

Respuesta de `GET /v1/beneficiaries/validate-account?account=`. Resultado estructural de un número de cuenta. Bajo `data.attributes` se reporta el tipo detectado, el checksum, los metadatos del banco resuelto (cuando se puede) y, para CLABEs parciales de 17 dígitos, la versión auto-completada. Este endpoint **no** consulta Banxico — solo validación local.

Propiedades

Campo	Tipo	Descripción
`type` *	`string`	Tipo del recurso JSON:API.
`attributes` *	`object`	Resultado de la validación estructural.
`input` *	`string`	Texto recibido tal cual (sin normalizar).
`length` *	`integer`	Longitud en dígitos del input normalizado.
`is_numeric` *	`boolean`	`true` cuando el input original contenía únicamente dígitos (sin separadores).
`account_type` *	`string`	Tipo de cuenta detectado por longitud, o `unknown` para inputs parciales o fuera de rango.
`is_complete` *	`boolean`	`true` cuando el input está completo para su tipo (18 dígitos en CLABE, 13–19 en tarjeta, 10 en celular).
`checksum_valid` *	`boolean`	`true` cuando el dígito de control de la CLABE pasa, o el Luhn de la tarjeta es válido. Para celular siempre `false` (no aplica).
`computed_control_digit`	`string \| null`	Dígito de control CLABE calculado a partir de los primeros 17 dígitos. `null` cuando el tipo no es CLABE o el cálculo no es aplicable.
`auto_completed`	`string \| null`	CLABE de 18 dígitos auto-completada cuando el input venía con 17 dígitos y el control pudo calcularse. `null` en los demás casos.
`bank`	`object \| null`	Metadatos del banco resuelto, o `null` cuando no se pudo identificar. Para CLABE deriva del prefijo; para tarjeta deriva del BIN.
`banxico_code`	`string \| null`	Código Banxico SPEI de 5 dígitos cuando el banco está mapeado.
`name`	`string`	Nombre del banco.
`card`	`object \| null`	Metadatos adicionales del BIN cuando `account_type=card` y hubo coincidencia en el directorio. `null` en cualquier otro caso.
`bin`	`string`	Prefijo BIN consultado.
`brand`	`string \| null`	Marca de la tarjeta (Visa, Mastercard, etc.).
`type`	`string \| null`	Tipo de tarjeta (`debit`, `credit`, etc.).
`level`	`string \| null`	Nivel de la tarjeta (`classic`, `gold`, etc.).
`country_iso`	`string \| null`	ISO 3166-1 alpha-2 del país emisor.

Variantes

`allOf`

SuccessEnvelope
object

Usado en operaciones

GET /v1/beneficiaries/validate-account