Verifica CLABEs

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.

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"
}
'

const verification = await fintoc.v2.accountVerifications.create({
  account_number: '000000000000000000',
});

verification = client.v2.account_verifications.create(
    account_number="000000000000000000"
)

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í:

{
  "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í:

{
  "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.

Inicio

Recursos

Pagos

Transferencias

Movimientos

Verifica CLABEs

Crear una verificación de cuenta

Monitorear el estado de la verificación

​Crear una verificación de cuenta

​Monitorear el estado de la verificación

Crear una verificación de cuenta

Monitorear el estado de la verificación