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.

Here's how to get started:

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

    note

    If you are unsure about which option to choose during registration, select Create a corporate account. Freelancer accounts are not supported in Revolut Business.

  2. Provide details: Fill in the necessary details to create your account. When asked for confirmation, click the Fill code button in the top right corner of the screen.

    note

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

  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. Access credentials: Once finished the registration, you can start using your sandbox-specific credentials. These 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:

  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 Open in the top right corner of the pop-up window.

    note

    We don't send the login confirmation email in Sandbox environment.

  3. Navigate to Merchant API settings: Once logged in, access the Merchant API settings page by clicking in the top right corner, then selecting APIs > Merchant API. Here you can access your Sandbox API keys (Public, Secret) specific to your Merchant account.

  4. Get API keys: To generate your Sandbox API Secret key, click the Generate button.

tip

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

Test payments​

note

Only test cards will work in the Sandbox environment.

Test 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:

Test using the API​

note

Apple Pay and Google Pay are 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 RevolutCheckout widget or Revolut Pay.

Here is what it should look like:

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

What's next​

Previous2. Generate API keys
NextImplementation checklist
Was this page helpful?