🇪🇸 Español
Verificación de Cuentas
Creación de Verificaciones de Cuentas
POST /v1/account_verifications).Este endpoint permite a los clientes enviar detalles de cuentas y titulares de cuentas, que luego se comparan contra los registros mantenidos por la institución financiera correspondiente.
Catálogo de Modelos de Verificación
México
Colombia
México – Verificación de Titularidad de Cuenta
México – Verificación de Detalles de Cuenta
Este modelo verifica si la información de cuenta y titular de cuenta proporcionada coincide con los registros oficiales de la institución financiera.
Solo se admiten cuentas de la geografía MEX, y deben ser cuentas CLABE. Una vez que el proceso de verificación se complete, el campo
El resultado
Las respuestas de verificación se proporcionan solo dentro de los horarios establecidos.
| Modelo | Geografía | Tipo de Cuenta | Descripción |
|---|---|---|---|
mex_acc_ownership_1 | MEX | CLABE | Confirma la titularidad de una cuenta CLABE validando el número de cuenta y la identificación del titular de la cuenta |
Campos Requeridos
| Campo | Descripción |
|---|---|
account_number | Número de cuenta CLABE (18 dígitos) |
account_type | Debe ser clabe |
account_holder_id_type | Tipo de identificación (rfc o curp) |
account_holder_id_number | Número de identificación del titular de la cuenta |
Resultados de Verificación
verification_response devolverá uno de los siguientes valores:| Resultado de Verificación | Descripción |
|---|---|
matched | La información del titular de la cuenta coincide con los registros de la institución financiera |
unmatched | La información del titular de la cuenta no coincide con los registros |
unresolved | La verificación no pudo validar de forma concluyente uno o más campos |
unresolved puede ocurrir debido a formatos inválidos, identificadores incorrectos, o intentos de verificación repetidos en un período corto.Consideraciones de Verificación de Cuentas
| Condición | Descripción |
|---|---|
| Horario de respuesta | 7:00 a.m. – 6:30 p.m. en días hábiles, 7:00 a.m. – 4:00 p.m. en días no hábiles |
| Tiempos de respuesta | Dependen del banco receptor |
| Reintentos | Validaciones repetidas en intervalos cortos pueden resultar en fallas; espere al menos 12 horas antes de reintentar |
Objeto de Estado de Verificación
| Estado | Código | Descripción |
|---|---|---|
processing | NA | La verificación se está procesando |
completed | NA | El proceso de verificación se completó |
failed | F006 | La cuenta no pudo ser validada |
Acciones realizadas en Verificaciones de Cuentas
🔑 Crear
🔍 Consulta
Descripción: Crear una nueva solicitud de verificación de cuenta usando un modelo soportado.Qué esperar después de la acción:
Un objeto de Verificación de Cuenta que incluye: 📘 Aprende más: 🔗 Crear una Verificación de Cuenta
Un objeto de Verificación de Cuenta que incluye:
id (ej., av_xxxxx)modelgeoverification_requestverification_responsestatusObjeto de Verificación de Cuenta
Atributos Clave
| Campo | Descripción |
|---|---|
id | Identificador único de la verificación |
creator_id | Identificador del cliente que realizó la verificación |
model | Modelo de verificación utilizado |
geo | Geografía de la cuenta verificada |
verification_request | Datos de cuenta y titular enviados |
verification_response | Resultado de la verificación |
status | Estado operacional de la verificación |
external_id | Referencia externa proporcionada por el cliente |
created_at | Marca de tiempo de creación |
updated_at | Marca de tiempo de última actualización |
Cómo Comenzar
Identificar el caso de uso de verificación
Determinar si se requiere verificación de cuenta antes de crear una contraparte o iniciar un movimiento de dinero.
Seleccionar el modelo de verificación apropiado
Usar el modelo de verificación soportado que coincida con la geografía y tipo de cuenta.
Preparar datos de verificación
Asegurar que los números de cuenta y campos de identificación estén correctamente formateados.
Crear la verificación de cuenta
Enviar la solicitud de verificación usando la API de Verificación de Cuentas.
Manejar el resultado de verificación
Usar la respuesta de verificación para decidir si proceder con operaciones posteriores.
Qué esperar después de usar esta API
Reducción de rechazos de pagos
Validar información del destinatario antes de iniciar movimientos de dinero.
Mejora en la precisión de datos
Asegurar que los datos de contrapartes y cuentas coincidan con los registros de la institución financiera.
Mitigación de riesgo operacional
Detectar discrepancias o verificaciones no resueltas temprano en el flujo de trabajo.
Consistencia entre funcionalidades
Reutilizar resultados de verificación a través de flujos de Contrapartes y Movimientos de Dinero.
Modified at 2026-02-17 00:11:02