🌎 API Environments

Make use of Belvo's three environments to prototype, test, and then put your integration into production 🥸.


Available for:

  • 🟢 Aggregation and Enrichment
  • ⚪️ Payment Inititation

Use our Sandbox environment to build your integration. We offer dummy-data that mimics that of real-world use cases, which means you can test out all the endpoints, use the widget, and implement webhooks - just the same as with real-world data!

All you need to get started with the Sandbox environment is to get your API keys. We really recommend that you start creating your integration in this environment.


We really recommend that while you're integrating with Belvo, you start with the Sandbox environment, proceed to Development, and finally make the jump to Production.



Please note that the Development Environment will be deprecated in Q2 2024.

To improve your integration experience, we will be deprecating our development environment in Q2 2024 and substituting it with direct access to production with an activity limit that you can use for free.

Why the change?

Maintaining a separate development environment can pose challenges in ensuring feature parity with production, particularly in terms of performance and response times. By providing direct access to production, we aim to give you a more consistent and reliable experience.

What will happen with my existing data in development?

Data from links created in development will be deleted. Recurrent activity will stop and credentials of links will be deleted.

If you are currently using our development environment, our support team will reach out to you with additional details on the process. And of course, if you have any questions, do not hesitate to contact us!


Available for:

  • 🟢 Aggregation and Enrichment
  • 🟢 Payment Inititation

After you have tested your integration in the Development environment and are ready to go live, you'll need to request access to our Production environment. After you request access, our Sales Team will get in contact with you to schedule a meeting just to make sure your needs are satisfied, and then you'll just need to go through a certification process with one of our engineers to make sure that your integration is running optimally. To prepare for the certification meeting, just follow our Integration checklist.

Once your integration is certified, all you'll need to do is:

  • Request Production API keys (and change your Development API keys in the code to these new ones).
  • Change the base URL that you make requests to from development.belvo.com to api.belvo.com.
  • If you're using webhooks, make sure to set a Production URL for your webhooks.


Payment Initiation

For our Payment Initiation solution, the base URL you need to use is: api.belvo.com/payments/