Guides • Accept Payments
3. Set up a test environment with Revolut Sandbox

Set up a test environment with Revolut Sandbox


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.


    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.


    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.

    Revolut Business Sandbox registration

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.


    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 your profile icon in the top left 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: If you're visiting this page for the first time, you'll need to initiate the process by clicking the Get started button. To generate your Sandbox API Secret key, click the Generate button.

Revolut Business Sandbox - Merchant API keys


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

Test payments


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


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 to
  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

Was this page helpful?