Set up a test environment with Revolut Sandbox

When preparing to integrate your services with your Revolut Merchant account, it's crucial to conduct thorough testing before going live.

The Revolut Business Sandbox environment is designed specifically for this purpose, offering a safe, isolated space where you can simulate transactions and integrations without affecting your live operations.

Create a Sandbox account

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

Here's how to get started:

Register: Visit the Revolut Business Sandbox sign-up page and register a new account.
Provide details: Fill in the necessary details to create your account.
- If you're unsure about which option to choose as Legal business type, select Public Limited Company. Freelancer accounts are not supported in Revolut Business.
- 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.
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.
Log in: Once the registration is complete, you can start using your account. These account credentials are unique to the Sandbox environment and cannot be used in the Production environment.

Get Sandbox API keys

To test payment methods and API calls in the Sandbox environment, you have to get the appropriate API keys linked to your Sandbox Merchant account.

Here's how to do it:

Log in to your Revolut Sandbox account: Access the Revolut Business Sandbox log in page and enter your credentials.
Confirm your login attempt: Click Skip email verification in the top right corner of the pop-up window.
Navigate to Merchant API settings: Once logged in, access the Merchant API settings page by clicking your profile in the top right corner, then selecting Settings → APIs → Merchant API tab. Here you can access your Sandbox API keys (Public, Secret) specific to your Merchant account.
Generate API keys: To generate your Sandbox API Secret key, click the Generate button.
Save API keys: Use the button copy and paste your API keys where you want to use them.

Point your integration at Sandbox

Using the plugins

If you have installed one of our plugins, you can test payments by changing the mode of the plugin to Sandbox mode (or Test mode in some cases) and providing your Sandbox API Secret key in the configuration. To configure each of our plugins, see:

Using the API

If you are using your custom implementation or wish to test our APIs, just follow these 2 steps:

Change the address of the endpoints that you want to test from https://merchant.revolut.com/ to https://sandbox-merchant.revolut.com/.
Set the mode parameter to sandbox in the options of Token-based initialisation or Payments module.

Here is what it should look like:

type RevolutCheckout = (
  token: string,
  mode: 'sandbox'
) => Promise<Instance>;

Create a Sandbox account​

Get Sandbox API keys​

Point your integration at Sandbox​

Using the plugins​

Using the API​

What's next​

Create a Sandbox account

Get Sandbox API keys

Point your integration at Sandbox

Using the plugins

Using the API

What's next