← Volver al índice de esquemas

`ValidationRequest`

Parámetros para validar una transferencia SPEI contra el CEP Banxico. Se requiere al menos uno de `clave_rastreo` o `referencia_numerica`; si ambos se omiten el servidor devuelve 422.

Propiedades

Campo	Tipo	Descripción
`fecha` *	`string (date)`	Fecha de la transferencia en formato ISO 8601 (YYYY-MM-DD). Debe coincidir con la fecha registrada en el CEP; diferencias de ±1 día pueden producir un resultado `not_found`.
`monto` *	`number (double)`	Importe de la transferencia en pesos mexicanos (MXN), mayor que cero y con hasta dos decimales. Debe coincidir exactamente con el monto registrado en el CEP; cualquier diferencia puede producir `not_found`.
`clave_rastreo`	`string`	Clave de rastreo SPEI generada por el banco emisor: cadena alfanumérica de 18 a 30 caracteres. Requerida si `referencia_numerica` está ausente; pueden enviarse ambas simultáneamente para mayor precisión de búsqueda.
`referencia_numerica`	`string`	Referencia numérica de la transferencia: entre 1 y 7 dígitos. Requerida si `clave_rastreo` está ausente; ambas pueden enviarse simultáneamente.
`emisor`	`string`	Nombre del banco emisor. Texto libre; el sistema lo normaliza contra el catálogo Banxico. Ignorado para CLABE y tarjeta, ya que el banco emisor se deriva del prefijo. Para celular/DiMo (10 dígitos), su presencia mejora la resolución del banco receptor.
`receptor`	`string`	Nombre del banco receptor. Para CLABE (18 dígitos) y tarjeta (13-19 dígitos) el banco se deriva automáticamente del prefijo/BIN y este campo se ignora. Solo es relevante cuando `cuenta_beneficiaria` es de 10 dígitos (celular/DiMo) y no puede resolverse por otros medios.
`cuenta_beneficiaria`	`string`	Cuenta destino del SPEI: CLABE de 18 dígitos, número de tarjeta de 13 a 19 dígitos, o número de celular DiMo de 10 dígitos. El tipo se autodetecta por longitud y se valida el checksum correspondiente (CLABE: dígito verificador estándar; tarjeta: Luhn). Para celular, el banco receptor se resuelve en orden: whitelist del usuario → catálogo global; si no se encuentra, el resultado es `error` con código `bank_code_unresolvable_for_phone`.
`retry_policy`	`object`	Política de reintentos automáticos para esta validación. Si se omite, se aplica la política configurada en `PUT /v1/users/me/retry-policy`. Los reintentos no consumen cuota de validaciones.
`enabled`	`boolean`	Activa o desactiva el ciclo de reintentos para esta validación. Si es `false`, los demás campos se ignoran.
`max_retries`	`integer`	Número máximo de reintentos automáticos. Una vez alcanzado, el ciclo pasa al estado terminal `exhausted`. El tope superior depende del plan (`retry_max_retries`) o del default global `max_retries_cap` (típicamente 5–10).
`interval_seconds`	`integer`	Segundos de espera entre cada reintento (300–86400, es decir, 5 minutos a 24 horas).
`outcomes`	`array`	Resultados de validación que habilitan un reintento. Por defecto el ciclo se activa con `not_found`, `cep_unavailable` y `error`; los clientes que no quieran reintentar errores Banxico HTTP 5xx pueden enviar `["not_found", "cep_unavailable"]`.

Variantes

`anyOf`

object
object

Usado en operaciones

POST /v1/validate