API StatusAPI ReferenceError DocsInstitutionsSupportSign inCreate a Sandbox account

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 💪.

Suggest Edits

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.

  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.

ErrorMessageTroubleshooting
ACCESS_TOKEN_ERRORA 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_ERRORA 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_ERRORThe company logo must be an .svg.Double check that your logo image follows our branding requirements.
COMPANY_BENEFIT_REQUIREDYou 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_ERRORThe 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_ERRORThe company benefit content can have a maximum of 140 characters.Just cut down your content text to be within the character maximum.
COUNTRY_CODES_ERRORYou 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_ERRORYou 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_ERRORA <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_ERRORYour 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_ERRORYour 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_ERRORYour 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 10 months ago