2. Set up a test environment with Revolut Sandbox

Caution

The Sandbox and Production accounts are not connected in any way, so make sure you use the appropriate credentials for each.

When preparing to integrate your application with your Revolut Business account, it's crucial that you conduct thorough testing before you go live.

The Revolut Business Sandbox environment is a non-production environment that was designed specifically for this purpose, offering a safe, isolated space where you can simulate making payments, retrieving transactions, managing your counterparties, your team and cards, and more, all without affecting your live operations.

You can also use it to try the Business API — creating a Sandbox account is quick, and you can use mock data for testing.

Tip

You don't need to provide your real personal data in Sandbox. You can sign up using any contact details or country available, as in Sandbox, these values are treated as mock data and won't be verified.

Create a Sandbox account​

The Sandbox environment operates independently of the Production environment. This means that you cannot use your existing Production credentials to log in or perform tests in Sandbox. Instead, you'll need to create a dedicated Sandbox account.

Here's how to get started:

  1. Register: Visit the Revolut Business Sandbox sign-up page to register a new account.

  2. Provide details: Fill in the necessary details to create your account.

    • When you see the pop-up about verification email, click the Skip email verification button in the top right corner.
    • When asked for a confirmation code, click the Autofill code button above the input field.
    Email/SMS confirmation

    We don't send confirmation emails or SMS for the Sandbox environment.

    Instead, the Sandbox interface is enhanced with helper buttons (not available in Production) that let you proceed when such an approval or confirmation is needed.

  3. Receive automatic approval: Unlike the Production environment, where account verification and approval might take some time, Sandbox account approvals are automatic. This lets you jump straight into testing without any delays.

  4. Log in: Once the registration is complete, you can log in to Sandbox and start using your account. These account credentials are unique to the Sandbox environment and cannot be used to log in to the Production environment.

Get Sandbox API keys​

To start using your Sandbox account with the Business API, you must generate and upload your certificate, and enable access for your application

This process is described in the next guide: 3. Make your first API request. Follow the steps listed there, selecting the Sandbox option where available:

  1. Generate and upload your certificate to grant your application access to your Revolut Business account via the Business API.
  2. Provide a client assertion JWT to obtain a signing key.
  3. Consent to the application in the Revolut Business app to obtain an authorization code.
  4. Exchange authorization code for access token to authenticate your requests to the Business API.*
  5. Try your first API request to test your setup and get a list of all your accounts.*

*Make sure that you make these requests to the Sandbox URL.

After you complete and validate the setup, you can make requests to the Business API. If you encounter issues, such as your access token has expired, see the Troubleshooting section.

Sandbox URL

The Business API uses different host addresses depending on the environment:

  • Production: https://b2b.revolut.com/api/1.0
  • Sandbox: https://sandbox-b2b.revolut.com/api/1.0

To use the Business API with your Sandbox account, make sure that you use the correct host address for the endpoints that you want to test.

Where there are multiple versions of the API available, make sure to use the correct version in the URL. For example, for Webhooks v2, use: https://sandbox-b2b.revolut.com/api/2.0/webhooks.

Previous1. Sign up for Revolut Business account
Next3. Make your first API request
Was this page helpful?