Set up a test environment with Revolut Sandbox

Caution

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

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.

Caution

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

Instead, the Sandbox environment offers helper buttons to let you proceed when approval or confirmation is needed.

Here's how to get started:

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

  2. 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.

  3. 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 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.

Caution

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

Instead, the Sandbox environment offers helper buttons to let you proceed when approval or confirmation is needed.

Here's how to do it:

  1. Log in to your Revolut Sandbox account: Access the Revolut Business Sandbox log in page and enter your credentials.
  2. Confirm your login attempt: Click Skip email verification in the top right corner of the pop-up window.
  3. 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.
  4. Generate API keys: To generate your Sandbox API Secret key, click the Generate button.
  5. Save API keys: Use the button copy and paste your API keys where you want to use them.
Tip

If you encounter any issues during Sandbox registration, we advise you try to create another account.

Point your integration at Sandbox​

Note

Only test cards will work in the Sandbox environment. For full payment-flow test scenarios (Revolut Pay, Google Pay, and error cases), see Test payment flows.

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​

Note

Apple Pay is not available in the Sandbox environment.

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

  1. Change the address of the endpoints that you want to test from https://merchant.revolut.com/ to https://sandbox-merchant.revolut.com/.
  2. 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>;

What's next​

PreviousGet started
NextImplementation checklist