API Console
Help

Environments

Revolut operates in two isolated environments: Sandbox for testing and Production for real data.

Before you proceed with your setup, read this page: it shows how the two environments differ and what to expect in each. Everything else in this space assumes the split.

How it works

Proper testing and deployment to Production need two separate setups:

  • Your test environment - any pre-production deployment (like local, QA or staging), pointed at Revolut Sandbox: sandbox endpoints, your Sandbox API key, test cards, and test data that never settles.
  • Your live deployment - your production deployment, pointed at Revolut Production: live endpoints, your Production API key, real customer cards, and real money.

The two environments are completely isolated: your Sandbox key and test cards only work against Sandbox, your Production key only against live endpoints. When you finish testing and are ready to go live, you update your entire setup at once to point to Production endpoints and data.

The two setups side by side:

Your test environmentYour live deployment
Revolut environmentSandboxProduction
Base URLhttps://sandbox-merchant.revolut.com/https://merchant.revolut.com/
API keyConsole Sandbox API keyConsole Production API key
CardsTest cards onlyReal customer cards
MoneyMock transactions - nothing settlesReal money
Emails and SMSNot sent - helper buttons simulate successSent as normal

Keys in API Console

Both setups get their keys from one place: the API Console, which serves both environments and lets you easily switch between Sandbox and Production.

Plugin environments

Running a no-code plugin? The same two setups apply: connect a staging store in test mode with your Sandbox key, and your live store with your Production credentials. See Set up test environment.

Webhooks

If your server allowlists incoming traffic, allowlist Revolut's webhook sources separately for each environment:

EnvironmentWebhook IPs
Sandbox35.242.130.242, 35.242.162.241
Production35.246.21.235, 34.89.70.170

When you switch, register your Production webhook URL and allowlist the Production IPs. For delivery retries, payload signature verification, and operational guidance, see Use webhooks.

What's next

Set up test environment
Create a Sandbox account and point your integration at Sandbox
Test cards
The full list of Sandbox test cards and their outcomes
Test payment flows
Walk through checkout flows in Sandbox - payment links, Revolut Pay, and Google Pay
Sandbox test scenarios
The order, refund, and webhook scenarios every backend should handle
Rate this page