Widget errors and troubleshooting

Nobody is perfect - and sometimes you might run into some issues when integrating the widget. Thankfully, we have put together a list of errors for you and how to solve them 💪.

Common Errors

While integrating the widget, you may find some troubles such as:

  • the widget doesn't open
  • the widget opens, but has no content

For any of those issues, check the following potential solutions:

  1. Scope of access token:
    Make sure that you are specifying the scope of your access token when creating it. Check the cURL example here. For our SDKs, we handle the generation of the scope for you.

  2. Access token generation: 
    Make sure that you are generating the access_token from your server-side.

Console Errors

While you're integrating the widget, or perhaps even when it's in production, you may see the following errors in your console. If you do, just follow the instruction in the Troubleshooting column to solve the issue.

Error

Message

Troubleshooting

ACCESS_TOKEN_ERROR

A valid access token is mandatory. Find more info in our documentation: https://developers.belvo.com/docs/connect-widget

Make sure that you are generating your access_token in your server side. Check out our docs for more info.

CALLBACK_ERROR

A callback function is mandatory. Please implement it. Find more info in our documentation: https://developers.belvo.com/docs/connect-widget#widget-callbacks

You need to create a callback function to handle the data upon successful link creation.

COMPANY_LOGO_ERROR

The company logo must be an .svg.

Double check that your logo image follows our branding requirements.

COMPANY_BENEFIT_REQUIRED

You must provide both company_benefit_header and company_benefit_content parameters.

If you're using a custom benefit, you need to supply both the custom_benefit_header and the custom_benefit_content parameters.

COMPANY_BENEFIT_HEADER_ERROR

The company benefit header can have a maximum of 30 characters.

Just cut down your header text to be within the character maximum.

COMPANY_BENEFIT_CONTENT_ERROR

The company benefit content can have a maximum of 140 characters.

Just cut down your content text to be within the character maximum.

COUNTRY_CODES_ERROR

You must provide a valid country code. Use one or more of the following:

Make sure you have used the correct country codes and that you don't have any typos. Check out an example here.

ACCOUNT_TYPES_CODES_ERROR

You must provide a valid institution type. Use one or more of the following:

Make sure you have used the correct institution type and that you don't have any typos. Check out an example here.

BELVO_DIV_ERROR

A <div id="belvo"></div> is mandatory. Find more info in our documentation: https://developers.belvo.com/docs/connect-widget'

Make sure that you have added the Belvo div in your application. Check out this article for more info.

CALLBACK_DEFINITION_ERROR

Your callback function threw an error. Please review your function and retry.

Your onSuccess callback function is either not able to handle the data from Belvo or doesn't exist. Double check that your function doesn't have any typos in its name and that it is successfully handling the data.

ONEXIT_DEFINITION_ERROR

Your onExit function threw an error. Please review your function and retry.

Your onExit callback function is either not able to handle the data from Belvo or doesn't exist. Double check that your function doesn't have any typos in its name and that it is successfully handling the data.

ONEVENT_DEFINITION_ERROR

Your onEvent function threw an error. Please review your function and retry.

Your onEvent callback function is either not able to handle the data from Belvo or doesn't exist. Double check that your function doesn't have any typos in its name and that it is successfully handling the data.

👍

Further support

If you're still running into issues, just shoot us an email: [email protected]


Did this page help you?