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:

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

Test payments​

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:

• Configuration of the WooCommerce plugin
• Configuration of the Prestashop plugin
• Configuration of the Adobe Commerce (Magento 2) plugin
• Configuration of the OpenCart plugin
• Configuration of the Shopify plugin

Test using the API​

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​

• Learn more about Test cards
• Learn more about testing your implementation
• Learn more about Revolut Pay
• Learn more about accepting card payments
• Learn more about our no-code plugins
• Learn more about the Merchant API