Verifica cuentas mexicanas

La verificación de cuentas confirma una cuenta de destino mexicana identificada por un número estandarizado de cuenta bancaria mexicana (CLABE), un número de tarjeta de débito de 16 dígitos o un número de teléfono móvil de 10 dígitos. Fintoc envía un microdepósito de 0.01 MXN desde el saldo de tu cuenta al 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
}

Verificar una tarjeta de débito o un número de teléfono móvil

Una CLABE identifica a su banco, pero una tarjeta de débito o un número de teléfono móvil no. Para verificarlos, agrega el institution_id de 5 dígitos del banco, según la lista de instituciones de Banco de México. Si omites institution_id, la API devuelve un error 400 Bad Request.

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": "4111111111111111",
  "institution_id": "40012"
}
'

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

verification = client.v2.account_verifications.create(
    account_number="4111111111111111",
    institution_id="40012"
)

La API devuelve el mismo objeto account_verification, con account_type igual a debit_card o mobile. La respuesta se ve así:

{
  "id": "accv_a1b2c3d4e5f6g7h8",
  "object": "account_verification",
  "status": "pending",
  "reason": null,
  "transfer_id": "tr_a1b2c3d4e5f6g7h8",
  "counterparty": {
    "account_number": "4111111111111111",
    "holder_id": null,
    "holder_name": null,
    "account_type": "debit_card",
    "institution": {
      "id": "40012",
      "name": "BBVA Mexico",
      "country": "mx"
    }
  },
  "mode": "test",
  "receipt_url": null,
  "transaction_date": null
}

Para números de tarjeta, la verificación de cuentas solo funciona con tarjetas de débito, no con tarjetas de crédito.

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.

​Crear una verificación de cuenta

​Verificar una tarjeta de débito o un número de teléfono móvil

​Monitorear el estado de la verificación

Crear una verificación de cuenta

Verificar una tarjeta de débito o un número de teléfono móvil

Monitorear el estado de la verificación