400
Si hubo un error al intentar obtener data de un endpoint o al intentar crear un link recibirás un mensaje indicando que pasó:
Para entender qué causó el error y qué acción debes tomar, revisa nuestro guíaErrores del API Belvo y errores del Widget.
Aquí tenemos la lista con todos los errores, causas y acciones a tomar, en caso de que ocurra alguno de ellos:
| HTTP Código | API Código de Error | Descripción default | Relevante al widget? | Widget código de erro | Widget descripción de erro | Causa | Ación |
| 500 | service_unavailable | "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution" | No | N/A | Hubo un cambio del lado de la institución que impide que funcione la integración de Belvo. El detalle puede ser intermitente o persistente. | Recomendamos repetir la llamada máxima 3 veces por si el detalle es intermitente. Al realizar la misma operación y recibir un tercer error 500, informe a Belvo con el request_id. | |
| 500 | unexpected_error | "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution" | Sí | Ha habido un error | Hubo un error al vincular su cuenta. Vuelva a intentarlo y, si el problema persiste, lo solucionaremos lo antes posible. | Hubo un cambio del lado de la institución que impide que funcione la integración de Belvo. El detalle puede ser intermitente o persistente. | Recomendamos repetir la llamada máxima 3 veces por si el detalle es intermitente. Al realizar la misma operación y recibir un tercer error 500, informe a Belvo con el request_id. |
| 400 | activation_failed | "The credentials provided were not accepted by the institution. Please verify CVV and NIP are correct." | Sí | N/A | N/A | El usuario final no ha activado su banca en linea con la institución con el cual intenta crear un link. Belvo intentó activar su banca en linea sin embargo el CVV y NIP ingresados son incorrectos. | Es necesario que el usuario final contacta a su banco para activar su banca en linea. El proceso de activar una banca en linea varía dependiendo la institución. El sitio web del banco debe indicar los pasos a seguir. Una vez que este activa su banca en linea, el usuario final podrá crear un link con Belvo con las mismas credenciales. *Es importante notar que son distintos una cuenta en el APP de la institución versus una banca en linea de la institución. |
| 400 | institution_down | "The financial institution is down, try again later" | Sí | Ha habido un error | Esta institución está temporalmente inaccesible. Por favor, inténtalo de nuevo más tarde y podremos procesar tu petición | La aplicación de la institución esta caído o en mantenimiento por lo tanto Belvo no puede crear nuevos links ni consumir información financiera. | Belvo monitorea las instituciones constantemente. Para recibir alertas ante un detalle con una institución sugerimos suscribir a nuestro Status Page de Instituciones. No ocurre frecuentemente que una institución este caído. *Es posible filtrar cuales instituciones son mostrados en el widget con el parámetro "institutions": []. Como filtrar las instituciones |
| 400 | institution_inactive | "The institution has been temporarily deactivated" | No | N/A | N/A | Belvo ha desactivado esta institución dentro del API. | Mientras que una institución este desactivada no es posible crear un link no consumir información financiera de un link. *Es posible filtrar cuales instituciones son mostrados en el widget con el parámetro "institutions": []. Como filtrar las instituciones |
| 400 | institution_unavailable | "The financial institution is unavailable" | Sí | Ha habido un error | Esta institución está temporalmente inaccesible. Por favor, inténtalo de nuevo más tarde y podremos procesar tu petición | La aplicación de la institución esta temporalmente caído o en mantenimiento por lo tanto Belvo no puede crear nuevos links ni consumir información financiera. | Belvo monitorea las instituciones constantemente. Para recibir alertas ante un detalle con una institución sugerimos suscribir a nuestro Status Page de Instituciones. *Es posible filtrar cuales instituciones son mostrados en el widget con el parámetro "institutions": []. Como filtrar las instituciones |
| 400 | invalid_link | "The link has been invalidated. You may need to update link credentials" | No | N/A | N/A | Se intentó realizar un POST a algún endpoint de un link con estatus invalid. * Un link con estatus valid pasa a estatus invalid después de 6 llamadas POST fallidos. | Es necesario revisar los errores de las llamadas POSTs mas recientes del link. |
| 400 | too_many_sessions | "Impossible to login, a session is already opened with the institution for these credentials" | Sí | Demasiadas sesiones abiertas | Parece que ya hay una sesión abierta en esta institución con tu usuario. Esta institución solo permite una sesión abierta a la vez. | Las instituciones financieras solo permiten que haya una sesión abierta a la vez. Si el usuario final tiene abierta su cuenta en la APP móvil o su banca en linea no será posible crear un nuevo link con Belvo o consumir data financiera de este usuario. | El usuario final debe asegurar de cerrar sesión en su APP móvil, tanto como en la banca en linea. También sugerimos cerrar la navegador o cualquier pestaña abierta. Una vez que el usuario final ha cerrado todas sus sesiones abierta podrá crear un link con Belvo o consumir data financiera de cualquier endpoint. |
| 400 | unconfirmed_link | "The link creation has not been completed yet" | No | N/A | N/A |
Se intentó consumir data de un link con estatus unconfirmed_link. * Un link tiene estatus unconfirmed_link cuando un token fue requerido para terminar de crear el link pero el token ingresado fue inválido. |
Es necesario que el usuario final ingresa un token válido con el widget en update-mode y este link_id. En el usuario final ingresa un token valido el estatus del link se actualizará a valid y se podrá consumir data del link. |
| 400 | unsupported_operation | "The resource you are trying to access is not supported by this institution" | Sí | Ha habido un error | Hemos tenido un error con tu petición. Por favor, inténtalo de nuevo y si el problema persiste, lo arreglaremos lo más pronto posible |
Se intentó consumir un endpoint que no existe para el tipo de institución especificada. Por ejemplo, no es posible consumir el endpoint de /invoices para un link de tipo bancaria. Únicamente se puede consumir el endpoint /invoices con links de tipo fiscal. Descripción de los endpoints y a qué tipo de link correspondan. |
Únicamente realizar POSTs a endpoints que correspondan al tipo de link especificada. Descripción de los endpoints y a qué tipo de link correspondan. |
| 400 | validation_error | "Bad request" | No | N/A | N/A | Hay un error sintáctico en la llamada. No se realizó la operación solicitado. |
1. Asegura que el endpoint es compatible con el tipo de link. 2. Revisa la url, los parámetros y el cuerpo de la llamada para un carácter incorrecto, o un carácter faltante. |
| 428 | activation_required | "This user doesn't have web access activated yet." | Sí | N/A | N/A | El usuario final no ha activado su banca en línea con la institución a la que intenta vincularse. |
Al recibir este código, el widget mostrará un flujo para habilitar la banca en línea para la cuenta ingresada por el usuario final. Durante este flujo, se solicitará el CVV y el PIN. |
| 428 | token_required | "A MFA token is required by the institution to login" | Sí | Token invalid | El token puede haber caducado, genere uno nuevo y vuelva a intentarlo. | El usuario final ingresó un token incorrecto o caducado en el widget. |
El usuario final debe ingresar un token válido con el widget en update mode. |
| 408 | request_timeout | "The request timed out, you can retry asking for less data by changing your query parameters." | Sí | Sesión expirada | El tiempo de respuesta fue demasiado largo y no se pudo establecer la conexión. Vuelva a intentarlo en unos minutos. | Belvo limita el tiempo para poder obtener todos los detalles de una cuenta y cerrar sesión. Se produce un tiempo de espera cuando hay una gran cantidad de datos y no se pueden recuperar dentro del tiempo asignado. Por ejemplo, si una cuenta tiene más de 2000 transacciones por cuenta por mes. |
Cuando se agota el tiempo de espera, la API de Belvo guarda su progreso en ese momento, por lo que recomendamos realizar la llamada nuevamente y posiblemente recuperar todos los datos con éxito. |
| 401 | token_not_valid | N/A | Sí | Sesión expirada | Su sesión ha caducado, actualice la página e intente vincular su cuenta nuevamente. | El access_token enviado para abrir el widget ha caducado. No se intentó la llamada realizada con este token. |
El usuario necesita volver a abrir el widget. |
También tenemos algunos errores relacionados con el inicio de sesión:
| HTTP Código | API Código de Error | Descripción default | Relevante al widget? | Widget código de erro | Widget descripción de erro | Causa | Ación |
| 400 | login_error | "A MFA token is required by the institution, but it’s not supported yet by Belvo." | No | N/A | N/A | Hubo un cambio de parte de la institución y no esta desarrollado el flujo requerido. | Repórtalo a Belvo con el request_id. |
| 400 | login_error | "Impossible to login, something unexpected happened while logging into the institution. Try again later." | Sí | Ha habido un error | Parece que ha habido un error al vincular tu cuenta. Por favor, inténtalo de nuevo y si el problema persiste, lo solucionaremos lo antes posible. | De forma aleatoria una creación de link será rechazado por el sistema de seguridad de la institución. Este rechazo no esta relacionado con el usuario o sus credenciales, es aleatorio. |
Sugerimos volver a intentar en intervalos de 15 minutos. * Como son aleatorios estos rechazos, es posible que de dos intentos a la misma institución en el mismo momento uno es rechazado y otro es exitoso. En caso de recibir este error después de multiples intentos o notar este error con frecuencia con una institución en particular, repórtalo a Belvo con el request_id. |
| 400 | login_error | "Login not attempted due to invalid credentials" | No | N/A | N/A | Hubo un intento previo con las mismas credenciales. No se volvió a enviar las credenciales a la institución. | Solicita al usuario final que confirma sus credenciales con el widget en update-mode. Solicita al usuario final ingresar las credenciales en el sitio oficial de banca en linea de la institución. En caso de que el usuario puede hacer login exitosamente en su banca en linea pero recibe invalid_credentials con el widget de Belvo repórtalo a Belvo con el request_id. |
| 400 | login_error | "Missing credentials to login to the institution" | Sí | Falta información | Por favor, ingresa toda la información para poder acceder a tu cuenta, parece que faltaba parte de la información necesaria | Cambio los requerimientos de la institución para las credenciales de este usuario, las credenciales ingresados previamente ya no son válidos. | Solicita al usuario final que confirma sus credenciales con el widget en update-mode. Solicita al usuario final ingresar las credenciales en el sitio oficial de banca en linea de la institución. En caso de que el usuario puede hacer login exitosamente en su banca en linea pero recibe invalid_credentials con el widget de Belvo repórtalo a Belvo con el request_id. |
| 400 | login_error | "The user account access was forbidden by the institution" | Sí | Error de la institución | Parece que la institución no está autorizando el acceso a esta cuenta. Por favor, contacta con tu entidad para que te pueda ayudar. | De forma aleatoria una creación de link será rechazado por el sistema de seguridad de la institución. Este rechazo no esta relacionado con el usuario o sus credenciales, es aleatorio. | Sugerimos volver a intentar en intervalos de 15 minutos. * Como son aleatorios estos rechazos, es posible que de dos intentos a la misma institución en el mismo momento uno es rechazado y otro es exitoso. En caso de recibir este error después de multiples intentos o notar este error con frecuencia con una institución en particular, repórtalo a Belvo con el request_id. |
| 400 | login_error | "The user account access was forbidden by the institution" | Sí | Acceso no permitido | La institución con la que intenta conectarse no permite el acceso a esta cuenta. | La creación de un enlace de forma aleatoria será rechazada por el sistema de seguridad de la institución. Este rechazo no está relacionado con el usuario o sus credenciales, es aleatorio. | Sugerimos tentar novamente em intervalos de 15 minutos. * Como essas rejeições são aleatórias, é possível que de duas tentativas para a mesma instituição ao mesmo tempo, uma seja rejeitada e a outra seja bem sucedida. Caso você receba esse erro após várias tentativas ou perceba esse erro com frequência com uma determinada instituição, informe-o à Belvo com o request_id. |
| 400 | login_error | "The user account is locked, user needs to contact the institution to unlock it" | Sí | Error de la institución | Parece que la institución no está autorizando el acceso a esta cuenta. Por favor, contacta con tu entidad para que te puedan ayudar | La institución regresó un error de login indicando que la cuenta esta bloqueada. | Es necesario que el usuario final contacta a su banco para desbloquear su cuenta. El proceso de desbloquear varía dependiendo la institución. El sitio web del banco debe indicar los pasos a seguir. Una vez que desbloquea su cuenta el usuario final podrá crear un link con Belvo o consumir su data financiera nuevamente. * Las bancas en linea o aplicaciones móvil de banco se bloquean cuando: * Para evitar que se bloquea una cuenta sugerimos: |
| 400 | login_error | "We could not complete the process to login into the institution" | N/A | N/A | N/A | N/A |