API Reference

API keys and authentication

Generate API Keys

To get your API keys:

  1. Log in to your Direct Debit Portal. (Sandbox Login | Production Login)
  2. Go to Developers -> API Keys. (Sandbox API Keys | Production API Keys)
  3. Click Generate API Keys.
  4. Save your Secret Key and Secret Password (they will only be displayed once).
  5. After saving and downloading your secret key and password, click Done.

✅ You're API keys are successfully generated.

Authentication

After getting your Secret Key and Secrety Password, provide them in the corresponding headers whenever making a request to a protected endpoint.

curl --request <the_method> \
     --url https://api.sandbox.directdebit.belvo.com/<the_endpoint>
     --header 'api-key-id: <Your secret-key-id>' \
     --header 'api-key-secret: <Your secret-password>'