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:
-
Scope of access token:
Make sure that you are specifying the scope of your access token when creating it. Check the cURL example here. -
Access token generation:
Make sure that you are generating theaccess_tokenfrom 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: Generate an access token. | 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: 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: Embed connect widget snippet. | 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].
Updated over 1 year ago