> ## 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.

# Verifica CLABEs

> Verifica una CLABE mexicana y el nombre del titular de la cuenta antes de enviar un payout completo con la API de Transfers de Fintoc, para evitar rechazos.

La verificación de cuentas confirma una cuenta bancaria mexicana identificada por su número estandarizado de cuenta bancaria mexicana (CLABE). Fintoc envía un microdepósito de 0.01 MXN desde el saldo de tu cuenta a la CLABE de destino. Cuando la verificación se completa, Fintoc devuelve la información del titular de la cuenta.

## Crear una verificación de cuenta

Una verificación de cuenta crea una `Transfer` de 0.01 MXN desde tu `Account` raíz para obtener la información del titular de la cuenta destino. Como esta llamada mueve dinero desde tu cuenta, debes firmar la solicitud con una JSON Web Signature (JWS). Consulta [cómo configurar llaves JWS](/es/guides/transfers/transfers-setup/setting-up-jws-keys).

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
       --url https://api.fintoc.com/v2/account_verifications \
       --header 'Authorization: YOUR_TEST_SECRET_API_KEY' \
       --header 'Fintoc-JWS-Signature: YOUR_JWS_SIGNATURE' \
       --header 'accept: application/json' \
       --header 'content-type: application/json' \
       --data '
  {
    "account_number": "000000000000000000"
  }
  '
  ```

  ```javascript Node theme={null}
  const verification = await fintoc.v2.accountVerifications.create({
    account_number: '000000000000000000',
  });
  ```

  ```python Python theme={null}
  verification = client.v2.account_verifications.create(
      account_number="000000000000000000"
  )
  ```
</CodeGroup>

Cuando solicitas una verificación de cuenta, la API devuelve un objeto `account_verification` con estado `pending`. Los campos `holder_id` y `holder_name` son `null` en esta respuesta inicial. Fintoc completa estos campos cuando la verificación se realiza con éxito. La respuesta se ve así:

```json theme={null}
{
  "id": "accv_a1b2c3d4e5f6g7h8",
  "object": "account_verification",
  "status": "pending",
  "reason": null,
  "transfer_id": "tr_a1b2c3d4e5f6g7h8",
  "counterparty": {
    "account_number": "000000000000000000",
    "holder_id": null,
    "holder_name": null,
    "account_type": "clabe",
    "institution": {
      "id": "mx_banco_bbva",
      "name": "BBVA Mexico",
      "country": "mx"
    }
  },
  "mode": "test",
  "receipt_url": null,
  "transaction_date": null
}
```

## Monitorear el estado de la verificación

Cuando Fintoc obtiene la transferencia y la información del titular, envía un webhook `account_verification.succeeded`. Este evento incluye la información del titular de la cuenta en un objeto `account_verification` con estado `succeeded`. El evento se ve así:

```json theme={null}
{
  "id": "evt_a4xK32BanKWYn",
  "type": "account_verification.succeeded",
  "object": "event",
  "mode": "test",
  "created_at": "2020-04-17T00:00:00.000Z",
  "data": {
    "account_verification_id": "accv_a1b2c3d4e5f6g7h8",
    "object": "account_verification",
    "status": "succeeded",
    "reason": null,
    "transfer_id": "tr_a1b2c3d4e5f6g7h8",
    "counterparty": {
      "account_number": "000000000000000000",
      "holder_id": "000000000",
      "holder_name": "Test Customer 1",
      "account_type": "clabe",
      "institution": {
        "id": "mx_banco_bbva",
        "name": "BBVA Mexico",
        "country": "mx"
      }
    },
    "mode": "test",
    "receipt_url": "https://www.banxico.org.mx/cep/",
    "transaction_date": "2020-04-17T00:00:00.000Z"
  }
}
```

Si Fintoc no puede obtener la información, recibes un webhook `account_verification.failed` con un campo `reason` que explica por qué falló la verificación.

Para más información sobre cómo recibir webhooks con Fintoc, consulta la [guía de webhooks](/es/guides/resources/webhooks-walkthrough).