WooCommerce Revolut Payment Gateway

1. Overview

WooCommerce Revolut Payment Gateway by PatSaTECH connects your store to the Revolut Business Merchant API. At checkout the plugin creates a Revolut order for the WooCommerce order and sends the customer to the secure Revolut Hosted Checkout Page, where they pay by card, Apple Pay, Google Pay or Revolut Pay (whichever Revolut enables on your account). Card data never touches your server.

When the customer returns, and again when Revolut sends a signed webhook, the plugin re-reads the Revolut order from the API and checks the amount and currency before it marks the WooCommerce order paid. You only paste one Secret API key: the webhook is registered for you. Refunds are made from the WooCommerce order screen.

2. Features

• Revolut Hosted Checkout Page
• Cards, Apple Pay, Google Pay, Revolut Pay
• Sandbox & Live keys
• Key checked when you save
• Webhook registered automatically
• Signed webhooks (Revolut-Signature v1)
• Return-URL check with the API
• Amount & currency verification
• Per-order lock: never paid twice
• Full & partial refunds
• Refund completion tracked
• Clear decline messages
• Cart kept after a decline
• Duplicate payments auto-refunded
• Unpaid orders cancelled on a timer
• Line items that add up exactly
• Optional forced 3D Secure
• Statement descriptor suffix
• HPOS compatible
• WooCommerce Blocks + classic
• Debug log (no secrets logged)
• Translation-ready (.pot)

3. Requirements

Tested on: WordPress 7.1.3, WooCommerce 11.2.1 (classic and Blocks checkout, HPOS), Revolut Business sandbox, PHP 8.1.34 (LiteSpeed). Requires PHP 7.4 or later.

4. Installation

Upload ZIP (recommended)

1. In WordPress admin go to Plugins → Add New → Upload Plugin.
2. Choose woorevolut-1.0.0.zip and click Install Now.
3. Activate WooCommerce Revolut Payment Gateway (PatSaTECH).

FTP / SFTP

1. Unzip the package.
2. Upload the woorevolut folder to /wp-content/plugins/.
3. Activate from the Plugins screen.

Step-by-step setup with screenshots

This walkthrough shows a complete setup, from the Revolut key to a refunded order. Click any screenshot to open it full size. Keys, Revolut order, payment and refund IDs, email addresses, phone numbers and IP addresses are blurred.

Part A: Revolut Business

1. Copy your Secret API key

   In Revolut Business click your avatar → Settings → APIs → Merchant API tab and copy the API secret key (sk_…). For testing use the sandbox at sandbox-business.revolut.com. Full details: Getting your Revolut Secret API key.

   

Part B: WordPress / WooCommerce

2. Upload the plugin

   Plugins → Add New → Upload Plugin, choose woorevolut-1.0.0.zip, then click Install Now.

   

3. Activate

   Click Activate Plugin. A Settings link appears in the plugin row.

   

4. Paste your sandbox key and save

   Go to WooCommerce → Settings → Payments → Revolut (PatSaTECH). Tick Enable Revolut, keep Sandbox ticked, paste the Sandbox secret API key and click Save changes. Leave Sandbox webhook signing secret empty: the plugin checks the key with Revolut, registers the webhook and fills the signing secret in for you.

   

   

   

Part C: Test order

5. Choose Revolut at checkout

   Add a product to the cart, fill in the billing details, select Card, Apple Pay, Google Pay & Revolut Pay and click Place order. The same option appears in the Checkout block.

   

6. Pay on the Revolut Hosted Checkout Page

   The customer is sent to Revolut’s secure page, which shows the amount, the order summary and the methods enabled on your account (here Revolut Pay, card and Google Pay). In the sandbox pay by card with 4929 4205 7359 5709, any future expiry and any CVC (see test cards).

   

   

7. Payment successful

   Revolut confirms the payment and sends the customer back to your store.

   

8. Thank-you page

   The customer lands on the WooCommerce order-received page. If Revolut is still confirming the payment, the plugin waits a few seconds and shows a “being confirmed” notice instead of Pay / Cancel buttons (see Pending payments).

   

9. Order is marked paid

   The order moves to Processing with a note such as “Revolut payment of $2.10 completed: Revolut order state is “completed” (checked on return).”. Whichever arrives first (the return or the webhook) completes the payment under a per-order lock; the other is ignored, so nothing is processed twice.

   

5. Getting your Revolut Secret API key

1. Sandbox (for testing): sign up for free at sandbox-business.revolut.com. The sandbox needs no real business verification and moves no real money (if it shows a “We need to confirm a few details” prompt, you do not need to complete it to get the sandbox API keys). Live: sign in to business.revolut.com; your Merchant account must be approved by Revolut first (see eligibility).
2. Click your avatar (profile picture) at the top right and choose Settings.

   

3. In Settings open APIs and select the Merchant API tab. Under API Keys you see the API secret key (it starts with sk_) and the API public key. Use the eye button to show the secret key or the copy button to copy it. You do not need the public key for this plugin.

   

4. Paste the key into the plugin’s Sandbox secret API key (or Live secret API key) field and save.
5. No webhook to create. Revolut Business has no webhook screen: the plugin registers the webhook through the Merchant API as soon as you save the key (see Webhooks). You can see it worked in the plugin: the message “Revolut Sandbox webhook registered for … and its signing secret saved.” (or “… already existed; its signing secret was saved.”), the webhook signing secret field filled in, and a line “Sandbox webhook … created for …” in the debug log.
6. Repeat in your live account at business.revolut.com when Revolut has approved your Merchant account (same Settings → APIs → Merchant API path; only the sandbox screens were captured for this guide). Sandbox and live keys are different and only work in their own environment.

6. Configuration

Go to WooCommerce → Settings → Payments → Revolut (PatSaTECH).

7. Webhooks (registered automatically, 6 events)

You do not need to create the webhook by hand, and you can’t: Revolut Business has no webhook screen. When you save a valid Secret key and the signing secret field is empty, the plugin calls the Revolut Merchant API, reuses a webhook that already points at your URL (adding any missing events) or creates a new one, and saves the signing secret. You can run it again at any time with Register sandbox webhook now / Register live webhook now. If you change the Secret key, the old signing secret is cleared and the webhook is registered for the new key.

Webhook URL: https://your-store.com/wc-api/patsatech_revolut_webhook/ (the plugin shows the exact URL for your site).

8. Eligibility, currencies & payment methods

Who can get a Revolut Merchant account. According to Revolut’s help centre (checked October 2026), Merchant accounts are available only to Revolut Business accounts opened in: Australia, Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Romania, Slovakia, Slovenia, Singapore, Spain, Sweden and the United Kingdom. Revolut Business customers in Switzerland, the United States and Liechtenstein cannot open a Merchant account, and businesses in other countries (for example India) are not eligible. To accept payments through the API or a plugin, Revolut also requires a fully working website. Revolut’s limit is £50,000 (or equivalent) per transaction.

Currencies. Cards, Apple Pay and Google Pay: AUD CAD CHF CZK DKK EUR GBP HKD HUF ILS JPY MXN NOK NZD PLN RON SEK SGD TRY USD ZAR (21 currencies). Revolut Pay additionally accepts AED CLP COP INR ISK KRW PHP QAR RSD SAR THB. The plugin sends amounts in each currency’s minor units (JPY, ISK, CLP and KRW have no decimals).

Payment methods. The Revolut Hosted Checkout Page shows the methods Revolut enables on your Merchant account: cards (Visa, Mastercard and others), Apple Pay, Google Pay and Revolut Pay. The plugin cannot turn individual methods on or off; that is done by Revolut.

9. Testing with the Revolut sandbox (test cards)

1. Tick Sandbox, paste your sandbox Secret key and save (the webhook registers itself).
2. Place a test order. You are sent to the Revolut sandbox checkout page.
3. Pay with a test card from the table below.
4. Check that the order moves to Processing with a Revolut note.

Use any future expiry date (for example 12/30) and any 3-digit CVC. Card numbers are from Revolut’s sandbox test-card list.

• 3D Secure: Revolut has no dedicated 3D Secure success card. Tick Always ask card holders for 3D Secure in the settings to see the challenge.
• Revolut Pay (sandbox): the one-time codes 1001–1005 choose the scenario; the sandbox passcode is 124455 (from Revolut’s test-flow docs).
• Apple Pay is not available in the Revolut sandbox. Google Pay results in the sandbox depend on the amount (see Revolut’s test-flow docs).

10. Order status flow

When a customer pays again for a Failed or Pending order, the plugin creates a new Revolut order (and cancels the old one if Revolut allows it), unless the old one is still fresh, unpaid and for the same amount.

11. Blocks vs classic checkout

Both are supported and were tested. Classic checkout uses the standard payment list; the Checkout block uses assets/js/blocks.js registered through the WooCommerce Blocks registry. HPOS (High-Performance Order Storage) is declared compatible.

12. Transaction ID

When a payment completes, the plugin saves the Revolut order ID as the WooCommerce Transaction ID (shown after “Payment via …” at the top of the order). The payment ID and card or wallet details are in the order note. Search for either in Revolut Business under Merchant → Payments.

Finding the payment in Revolut Business

In Revolut Business open Merchant in the left menu. The orders list shows every Revolut order the plugin created, with its status (Paid, Failed, Canceled, Partially refunded…), customer, channel Merchant API, card and amount. WooCommerce orders appear under their order number (for example 6488); the Revolut order ID is also the WooCommerce transaction ID.

Click an order to see its details, line items, customer and the Payment summary with every refund.

13. Partial and full refunds

1. Open the order and click Refund.
2. Enter quantities or amounts in the line-item refund fields (product, shipping, tax), or type the amount if taxes are off.
3. Click Refund $X via Revolut (PatSaTECH). The plugin calls the Revolut refund API and adds the note “Revolut refund of $1.00 requested (refund …, state processing).”

Revolut processes refunds asynchronously and sends no refund webhook, so the plugin checks each refund after 1, 1, 1, 2, 3, 5, 10, 30, 60, 360 and 1440 minutes, and again whenever you open the order. When Revolut finishes, it adds “Revolut refund of … completed” (or a prominent FAILED note). You can make several partial refunds; when the whole amount is refunded, WooCommerce sets the order to Refunded.

14. Pending, declined and expired payments

The Revolut page has no “cancel” button that returns to your store. If a card is declined, the customer can try another card on the Revolut page straight away. If they go back to your store with the browser’s Back button, the plugin re-checks the Revolut order and shows the reason on the checkout page, with the cart kept.

15. Decline messages customers see

Instead of a vague “payment failed”, the customer sees the reason, on the checkout page with their cart kept:

Developers can change any message with the woorevolut_decline_message filter (arguments: message, Revolut payment, table key):

add_filter( 'woorevolut_decline_message', function ( $message, $payment, $key ) {
    return 'funds' === $key ? 'Your card has insufficient funds. Please use another card.' : $message;
}, 10, 3 );

16. Duplicate payments

Rarely, a customer can pay twice for the same order, for example by paying in a second tab while a first payment was still being confirmed by Revolut. With Automatically refund duplicate payments on (the default), the plugin refunds the second payment in full through the Revolut API and adds a note; it does not create a WooCommerce refund, because the order itself stays paid. If Revolut cannot refund it yet, the plugin tries again later and finally flags it for a manual refund. With the setting off, you get a note and an admin notice so you can refund it yourself. Developers can also use the woorevolut_auto_refund_duplicates filter.

17. Debug log

Tick Debug log in the Revolut settings, then open WooCommerce → Status → Logs and choose the file that starts with woorevolut-. It shows API calls and responses, webhook events (always logged) and status changes. Secret keys, signing secrets and authorisation headers are never logged. Errors are logged even with the setting off.

Turn the log on before reproducing a problem, send the relevant lines to support, then turn it off again.

18. Troubleshooting & FAQ

“The Revolut key was rejected”

• Sandbox keys only work with Sandbox ticked, and live keys only with it unticked.
• Copy the Secret key (sk_…), not the Public key.
• If you regenerated the key in Revolut Business, paste the new one.

The webhook could not be registered

• Your site must be reachable over HTTPS from the internet (Revolut blocks localhost).
• “Too many webhooks”: Revolut allows 10 per account. Old ones can only be removed through the Merchant API (Revolut Business has no webhook screen; ask support), then click Register webhook now.

Paid in Revolut but the order is still Pending

• Check the webhook signing secret is filled in, or click Register webhook now.
• Make sure a firewall or security plugin is not blocking /wc-api/patsatech_revolut_webhook/.
• The plugin re-checks open orders on a schedule (WooCommerce Action Scheduler), so it also catches up on its own.
• Look at WooCommerce → Status → Logs, source woorevolut.

The customer sees a decline message

The card issuer or Revolut declined the payment. The customer can try another card. See Decline messages.

A refund still has no “completed” note

Revolut finishes refunds in the background (in the sandbox usually within a couple of minutes, sometimes much longer). Open the order to trigger a fresh check.

Can I hide the “Get $10 by joining Revolut” box on the Revolut page?

No. It is Revolut’s promotion on its hosted page and the Merchant API has no option to turn it off.

Can I show only some payment methods?

No. The Revolut Hosted Checkout Page shows the methods Revolut enables on your account.

Can I use it in India, Switzerland or the US?

Not for a live store: Revolut does not offer Merchant accounts there. See Eligibility.

Does it support subscriptions?

No. This plugin takes one-time payments.

19. API reference used

Hosts: sandbox https://sandbox-merchant.revolut.com, live https://merchant.revolut.com. Revolut docs: developer.revolut.com.

Developer filters: woorevolut_order_payload, woorevolut_line_items, woorevolut_decline_message, woorevolut_api_version, woorevolut_supported_currencies, woorevolut_icon, woorevolut_auto_refund_duplicates, woorevolut_return_wait_seconds (8), woorevolut_stuck_check_minutes (25), woorevolut_failed_cancel_minutes (10), woorevolut_confirming_wait_minutes, woorevolut_authorising_wait_minutes, woorevolut_processing_give_up_hours.

20. Tested on

• WordPress 7.1.3
• WooCommerce 11.2.1, classic checkout and Cart/Checkout Blocks, HPOS
• PHP 8.1.34 (LiteSpeed server); PHP 7.4 or later required
• Revolut Business sandbox Merchant account, USD orders. Live payments and Apple Pay not yet tested.
• Scenarios: card payment (Blocks and classic), automatic webhook registration, signed webhooks, declined cards with decline messages (insufficient funds, abandoned 3D Secure), partial and full refunds

21. Changelog

1.0.0 — 2026-10-18

• Initial release.
• Revolut Merchant API order + Hosted Checkout Page (cards, Apple Pay, Google Pay, Revolut Pay).
• HPOS compatible; WooCommerce Blocks and classic checkout.
• Sandbox and live keys, checked on save; webhook registered automatically (6 events) with manual “Register webhook now” buttons.
• Signed webhooks (Revolut-Signature v1, 5-minute tolerance); every change re-checked with the API under a per-order lock.
• Clear decline messages, cart kept, “being confirmed” notice; unpaid orders cancelled on a timer.
• Full and partial refunds with completion tracking; duplicate payments refunded automatically.
• Line items that add up exactly; optional forced 3D Secure; statement descriptor suffix; debug logging (no secrets).

22. Support

PatSaTECH
Email: [email protected]
Web: https://www.patsatech.com

Please include your WordPress, WooCommerce and PHP versions, whether you use the sandbox or live mode, and the relevant woorevolut log lines (never send your Secret key).