> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objeto Account verification

> >-

Una verificación de cuenta (account verification) confirma que una cuenta bancaria de contraparte existe y pertenece al titular esperado. Fintoc emite una transferencia de verificación desde una de tus cuentas hacia la cuenta de contraparte y luego reporta el resultado a través del `status` de la verificación. Usa una account verification para validar una cuenta de contraparte, como un número de cuenta bancaria estandarizado mexicano (CLABE), antes de hacer un pago hacia ella.

```json Account verification object theme={null}
{
  "id": "accv_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
  "object": "account_verification",
  "counterparty": {
    "account_number": "132969000000000190",
    "account_type": "clabe",
    "holder_id": "000000000",
    "holder_name": "Test Customer 1",
    "institution": {
      "id": "40012",
      "country": "mx",
      "name": "BBVA Mexico"
    }
  },
  "mode": "test",
  "reason": null,
  "receipt_url": "https://www.banxico.org.mx/cep/",
  "status": "succeeded",
  "transaction_date": "2026-03-11T20:42:49Z",
  "transfer_id": "tr_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
}
```

| Atributo           | Tipo   | Descripción                                                                                                                                                                                                                                                  |
| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`               | string | Identificador único de la account verification.                                                                                                                                                                                                              |
| `object`           | string | Tipo del objeto. Siempre `account_verification`.                                                                                                                                                                                                             |
| `counterparty`     | object | Detalles de la cuenta de contraparte verificada. Consulta los atributos de counterparty más abajo.                                                                                                                                                           |
| `mode`             | string | Uno de `live` o `test`. Las verificaciones realizadas con una API key live son `live`; las realizadas con una API key de test son `test`.                                                                                                                    |
| `reason`           | string | Motivo por el que la verificación falló. `null` salvo que `status` sea `failed`. Consulta las [razones de fallo de account verification](/es/reference/transfers-api/account-verification/account-verification-object#account-verification-failure-reasons). |
| `receipt_url`      | string | URL del comprobante de la verificación. `null` hasta que la transferencia de verificación se liquide.                                                                                                                                                        |
| `status`           | string | Estado de la verificación. Uno de `pending` (en progreso), `succeeded` (titularidad confirmada) o `failed` (no se pudo completar).                                                                                                                           |
| `transaction_date` | string | Fecha y hora en UTC (ISO 8601) en que se realizó la verificación. `null` hasta que la transferencia de verificación se liquide.                                                                                                                              |
| `transfer_id`      | string | Identificador de la transferencia emitida para verificar la cuenta. `null` hasta que se cree la transferencia de verificación.                                                                                                                               |

## Counterparty

| Atributo         | Tipo   | Descripción                                                                                                               |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- |
| `account_number` | string | Número de cuenta de la contraparte verificada. El número de cuenta bancaria estandarizado mexicano (CLABE) de 18 dígitos. |
| `account_type`   | string | Tipo de cuenta de la contraparte, en minúsculas. Siempre `clabe` para verificaciones de cuentas mexicanas.                |
| `holder_id`      | string | Identificador fiscal del titular de la cuenta. El RFC mexicano. `null` cuando no está disponible.                         |
| `holder_name`    | string | Nombre del titular de la cuenta. `null` cuando no está disponible.                                                        |
| `institution`    | object | Institución financiera de la contraparte. Consulta los atributos de institution más abajo.                                |

## Institution

| Atributo  | Tipo   | Descripción                                                                                                                                             |
| --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`      | string | Identificador de la institución. Consulta los [códigos de instituciones de México (Banxico)](https://www.banxico.org.mx/cep-scl/listaInstituciones.do). |
| `country` | string | Código de país ISO 3166-1 alpha-2 de la institución, en minúsculas. Siempre `mx`.                                                                       |
| `name`    | string | Nombre de la institución.                                                                                                                               |

## Razones de fallo de account verification

| Razón                            | Descripción                                                                                                                                                                                                                                                                                                                  |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `transfer_fail`                  | Fintoc no pudo enviar la transferencia de verificación.                                                                                                                                                                                                                                                                      |
| `cep_unavailable`                | Banxico no publicó el Comprobante Electrónico de Pago (CEP) antes de que la verificación expirara, alrededor de 30 minutos, por lo que Fintoc no pudo confirmar la cuenta. Vuelve a intentar la verificación más tarde.                                                                                                      |
| `unknown`                        | No se pudo determinar la razón.                                                                                                                                                                                                                                                                                              |
| Cualquier código de retorno SPEI | La institución de contraparte devolvió la transferencia de verificación por SPEI, el sistema interbancario de pagos de México. El código corresponde al `return_reason` de la transferencia. Consulta los [códigos SPEI](/es/reference/transfers-api/transfers/spei-codes) para conocer cada código y la acción recomendada. |