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

Crear una verificación de cuenta

Account Verification crea una transferencia de 0.01 MXN desde tu Account raíz para obtener la información del titular de la cuenta destino. Como el dinero se mueve desde tu cuenta, se requiere 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 una Account Verification, recibirás una respuesta que confirma que el proceso de verificación ha comenzado, devolviendo un objeto account_verification en estado pending. Ten en cuenta que la información solicitada está 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í tienes un ejemplo de cómo verificar cuentas usando nuestros SDKs 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 la información de la transferencia y del titular se obtiene exitosamente, recibirás un webhook account_verification.succeeded. Este evento incluirá la información del titular de la cuenta en un objeto account_verification con estado succeeded. Así es como debería verse 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 la información no puede obtenerse, 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

Movimientos

Verifica 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