← Volver al índice de esquemas
ValidateAccountResource
Recurso JSON:API con el resultado estructural de la cuenta validada.
Propiedades
| Campo | Tipo | Descripción |
|---|---|---|
type* | string | Tipo del recurso JSON:API. Siempre `account_validation`. |
attributes* | object | Resultado de la validación estructural. |
input* | string | Texto recibido (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 entradas fuera de rango. Los tipos reconocidos son `clabe`, `card` y `phone`. |
is_complete* | boolean | `true` cuando el input está completo para su tipo (18 dígitos en CLABE, 16 en tarjeta, 10 en celular). |
checksum_valid* | boolean | `true` cuando el dígito de control de la CLABE 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. Se deriva del prefijo o BIN. |
banxico_code | string | null | Código SPEI de 5 dígitos (cuando el banco está mapeado). |
name | string | Nombre oficial del banco resuelto. |
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. |
Usado en operaciones
GET /v1/beneficiaries/validate-account