API Reference

Sandbox

Available for:

  • 🟢 Payments

Use our Sandbox environment to build your integration. You can test out all the endpoints, use the payment link and setup link widgets, and implement webhooks - just the same as with real-world data!

All you need to get started with the Sandbox environment is:

  1. Sign up in the Sandbox portal.
  2. Verify the email you use during the signup process.
  3. Request our team to complete your onboarding and provide you with Sandbox API keys.
  4. If you want to use webhooks, ask our team to set your URL

📘

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

Production

Available for:

  • 🟢 Payments

Our Production environment will give you access to real payments and payouts to and from accounts using the Direct Debit platform.

After you have tested your integration in the Sandbox environment and are ready to go live, you'll need to reach out to our support team to access to our Production environment. Our support 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.

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

  1. Sign up in the Production portal.
  2. Verify the email you use during the signup process.
  3. Request our team to complete your onboarding and provide you with Production API keys.
  4. Change your Sandbox API keys in your code to the Production API keys.
  5. Change the base URL that you make requests to from api.sandbox.directdebit.belvo.com to api.directdebit.belvo.com.
  6. If you want to use webhooks, ask our team to set your URL