Authentication (Payments Brazil)

Belvo employs basic authentication using your secret keys. Just use your secretId as the username and secretPassword as the password. For example:

curl \
curl \

Generate your API keys

To generate your API keys:

  1. In the Production environment, go to the API keys section.

  2. In the Open Payments API Keys tab, click on Generate API Keys, which will automatically generate your API keys.

  3. Copy and save the two values you need to query Belvo products: secretId and secretPassword.


For security reasons, we only show the secretPassword once in the dashboard after the generation. Make sure you store it securely to be able to retrieve it later. If you lose your secretPassword, you'll need to reset your API keys.