La verificación de cuenta te permite verificar cuentas bancarias enviando microdepósitos (0.01 MXN) desde el saldo de tu cuenta Fintoc hacia el número de cuenta objetivo. Fintoc responderá con la información del titular resultante del comprobante de la transacción.

Crear una verificación de cuenta

Account Verification crea una Transfer de 0.01 MXN desde tu Account root para obtener la información del titular de la cuenta objetivo. Dado que se moverá dinero desde tu cuenta, se requerirá una firma JWS para completar la acción.

curl --request POST \
     --url https://api.fintoc.com/v2/account_verifications \
     --header 'Authorization: sk_test_9c8d8CeyBTx1VcJzuDgpm4H' \
     --header 'Fintoc-JWS-Signature: CNMaYaDGU3ZhFV1ve6p3sAdYXhEklej8DVIAMqIWCkpNmT6Jp7iigcndXwH5q3WQFHiswgIQU5-_-4rV3jKGptCROmEyWPW8_elhYH1apzAyjOjyZ55ygv37xKHzIFhixzAwmXlAv4pfD4lVelYWVNOSN7REA0QJeCy2vKdqZ5cjqCXQ1lkQUlzOE7dpuNoAkhAhAJJ8HaamFKy7Gl7uwmqbIr-dVYv21d_9O7mO26n0gy3zWXD2nJDxU5Mzl2pZd8-sFvUr9Kmp_YkeRMh4bSe0fr1Uc_YgkjpmYUyu7kaxRWTbAdJ3GwqWFMUDiyfhHdzvZPZyU4VkWreimoydMA' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "account_number": "012969100000000110"
}
'

Cuando solicitas un Account Verification, recibirás una respuesta confirmando que el proceso de verificación ha iniciado, devolviendo un objeto account_verification con estado pending. Ten en cuenta que la información solicitada vendrá vacía en la respuesta inicial. La respuesta debería verse así:

{
  "id": "accv_fdsjklsdjkls",
  "object": "account_verification",
  "status": "pending",
  "reason": null,
  "transfer_id": "tr_fdskjldasjkl",
  "counterparty": {
    "account_number": "012969100000000110",
    "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
}

Usando nuestros SDKs

Aquí un ejemplo de cómo verificar cuentas usando nuestros SDK de Python y Node:

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

Node

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

Monitorear el estado de la verificación

Cuando se obtenga exitosamente la información de la transferencia y del titular de la cuenta, recibirás un webhook account_verification.succeeded. Este evento incluirá la información del titular en un objeto account_verification con estado succeeded. Así se ve el evento:

{
  "id": "evt_a4xK32BanKWYn",
  "type": "account_verification.succeeded",
  "object": "event",
  "mode": "test",
  "created_at": "2020-04-17T00:00:00.000Z",
  "data": {
    "account_verification_id": "accv_fdsjklsdjkls",
    "object": "account_verification",
    "status": "succeeded",
    "reason": null,
    "transfer_id": "tr_fdskjldasjkl",
    "counterparty": {
      "account_number": "123456789123455789",
      "holder_id": "FLA1234567890", 
      "holder_name": "Carmen Marcela",
      "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 no se puede obtener la información, recibirás 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

Domiciliación bancaria

Movimientos

Verificar CLABEs

Crear una verificación de cuenta

Usando nuestros SDKs

Monitorear el estado de la verificación

​Crear una verificación de cuenta

​Usando nuestros SDKs

​Monitorear el estado de la verificación

Crear una verificación de cuenta

Usando nuestros SDKs

Monitorear el estado de la verificación