🇲🇽 ¿Cómo funciona la validación de cuenta CLABE?

Acá explicaremos como funciona el producto de validación de cuenta CLABE y validación de tarjeta de débito de Toku.

Hacer validación

Para la validación de tarjetas de débito, la única forma es hacerlo mediante la carga de un archivo por el backoffice.

Por otro lado hacer una validación de cuenta CLABE, existen dos formas. Una opción es directamente cargando un archivo por el backoffice y la otra es usando este endpoint. Esta request de devolverá un id del tipo bav_xxx, el cual debes guardar para cuando llegue la respuesta de la validación

Obtener respuesta

Para escuchar la respuesta debes colgarte de este webhook, el cuál te entregará la validación en formato json junto con el bav_xxx para que sepas a cual validación corresponde.

• Validación exitosa, status = “DONE”
  • En el caso que la validación sea exitosa, el campo reason vendrá como null y vendrán los campos del receiver_institution, customer_identifier, receiver_name y voucher_url completados
  • En el caso que la validación sí se haga, pero por alguna razón no se pudo obtener los datos de la CLABE, vendrá la razón en el campo reason. Las posibles opciones son:
    • “NONEXISTENT ACCOUNT”: La cuenta CLABE no existe
    • “BLOCKED ACCOUNT”: La cuenta CLABE está bloqueada
    • “CLOSED ACCOUNT”: La cuenta CLABE está cerrada
    • “ACCOUNT WITH INVALID CURRENCY”: La cuenta CLABE usa otra moneda distinta al peso mexicano (MXN)
    • “CEP NOT GENERATED”: No se pudo generar el CEP con la información desde Banxico
    • “NONEXISTENT ACCOUNT”: La cuenta CLABE no existe
      
      
• Validación fallida, status = “FAILED”
  • Los posibles errores que podemos ver cuando una validación falló al momento de hacerla son los siguientes
    • “DENIED BY RECIPIENT”: Por alguna razón la cuenta CLABE rechazó la validación
    • “EXCEEDS ACCOUNT MAX BALANCE”: La cuenta CLABE no permite recibir más dinero, por lo que no se puede validar
    • “EXCEEDS ACCOUNT MAX DEPOSITS”: La cuenta CLABE excede el límite de abonos permitidos al mes
    • “UNSUPPORTED BANK”: El banco receptor no es soportado aún por Toku
    • “INSTITUTION DISCONNECTED”: El banco receptor no está conectado a SPEI
    • “UNKNOWN ERROR”: Ocurrió un error inesperado, por favor intentalo nuevamente