Guides • Accept Payments
Configuration
doc

Configure the Revolut Gateway for WooCommerce plugin

Set up payment methods and other options for the Revolut Gateway for WooCommerce plugin.

To configure the plugin, navigate to the settings page in your WooCommerce admin panel: Plugins > Installed Plugins > Revolut Gateway for WooCommerce > Settings.

WooCommerce - API settings

Revolut's payment methods will appear on your checkout page only after you connect your Merchant account by providing your API key and enable the specific payment methods.

info

If you don't have a Revolut Business account, you can sing up here.

Connect your account

To use the Revolut Gateway for WooCommerce plugin, you need to connect your Revolut Merchant account by entering your API key in the plugin's API Settings.

Get your API keys

Depending on whether you want to test in the Sandbox environment or go live, you need to get the appropriate API key.

Sandbox API key

To test in the Sandbox environment:

  1. Log in to your Sandbox Revolut Business account.
  2. Click on your profile icon at the top right corner.
  3. Navigate to APIs > Merchant API.
  4. If this is your first time here, click Generate.
  5. Copy the Sandbox API Secret key.

Production API key

To use in the production environment:

  1. Log in to your Revolut Business account.
  2. Click on your profile icon at the top right corner.
  3. Navigate to APIs > Merchant API.
  4. If this is your first time here, click Generate.
  5. Copy the Production API Secret key.

Enter your API key in WooCommerce

  1. Log in to your WooCommerce dashboard as an admin.
  2. Navigate to Plugins > Installed Plugins.
  3. Find Revolut Gateway for WooCommerce and click Settings.
  4. On the API Settings tab, you will see options to enter your API keys.
    • Select Mode: Choose Sandbox or Live depending on whether you're testing or going live.
    • Sandbox API secret key: If you selected Sandbox mode, paste your Sandbox API key here.
    • Production API secret key: If you selected Live mode, paste your Live API key here.
  5. Click Save changes to apply the changes.
success

You have successfully connected your account by providing your API key!

General configuration

The API Settings tab provides essential settings for the Revolut Gateway integration with WooCommerce. You can select the environment you want to use, connect your Revolut Business account by providing your API key, and choose your preferred payment capture method.

These settings ensure your payment gateway operates correctly and securely, allowing you to test transactions, verify account connectivity, and decide whether to capture payments automatically or manually.

WooCommerce - API settings

To access the API Settings, go to Plugins > Installed Plugins > Revolut Gateway for WooCommerce > Settings. You have the following configuration options available:

  • Select Mode: Controls if the Revolut Payment Gateway uses simulated or real transactions.
    • Live: In this mode, your store will process real transactions. We recommend testing the plugin in Sandbox mode before going live.
    • Sandbox: In this mode, your store will simulate all transactions. This will ensure that no real purchases are made through your store, so you can test all features before going live in production.
  • Production/Sandbox API secret key: Depending on which mode you selected, provide the corresponding API secret key from your Merchant API settings:
  • Payment Action: Select how payments are captured.
    • Authorize and Capture: Payments are automatically authorised and captured at checkout.
    • Authorize Only: Payments are authorised at checkout, and you have to capture them manually, For more information, see: Manual capture.
  • Banner Visibility: Select if you want to display Revolut's promotional banner on your checkout to prompt customers to join Revolut and get rewards.

Configure payment methods

The Revolut Gateway for WooCommerce plugin supports multiple payment methods. You can enable or disable these payment methods from their respective tabs in the plugin settings.

Revolut Pay

The Revolut Pay tab allows you to turn on or off Revolut Pay, which toggles the availability of Revolut Pay on your checkout page.

This option allows customers to use Revolut Pay during checkout if enabled. If disabled, this payment option will not appear at checkout.

WooCommerce - Revolut Pay settings

To enable Revolut Pay:

  1. Log in to your WooCommerce dashboard as an admin.
  2. Go to Plugins > Installed Plugins > Revolut Gateway for WooCommerce > Settings > Revolut Pay.
  3. Check the Enable/Disable checkbox to enable Revolut Pay on your checkout page.
  4. Click Save changes to apply the changes.

Here is a complete list of available settings:

  • Enable/Disable: Toggle to enable or disable Revolut Pay on your checkout page.

  • Revolut Pay Express Checkout: Determine where the Revolut Pay button appears with the Fast checkout feature. You can select multiple options: Product, Cart.

    If none is selected, Revolut Pay won't be available as a Fast checkout payment option on product and cart pages.

    info

    The Product and Cart locations are for the Fast checkout feature. For more information, see: Features: Fast checkout.

  • Revolut Pay Button Theme: Select the colour theme of the Revolut Pay button. Possible values: Dark, Light, Light-Outline.

  • Revolut Pay Button Size: Choose the size of the Revolut Pay button. Possible values: Large, Small.

  • Revolut Pay Button Radius: Set the border radius of the payment button. Possible values: None, Small, Large.

caution

Remember to click the Save changes button to apply changes.

Apple Pay and Google Pay

note

Apple Pay and Google Pay are only available in Live mode.

The Apple Pay / Google Pay tab allows you to turn on or off Apple Pay and Google Pay, which toggles the availability of Apple Pay or Google Pay buttons on your checkout page.

This option allows customers to use Apple Pay or Google Pay during checkout if enabled. If disabled, this payment option will not appear at checkout.

WooCommerce - Apple Pay and Google Pay settings

To enable Apple Pay and Google Pay:

  1. Log in to your WooCommerce dashboard as an admin.
  2. Go to Plugins > Installed Plugins > Revolut Gateway for WooCommerce > Settings > Apple Pay / Google Pay.
  3. Check the Enable/Disable checkbox to enable Apple Pay and Google Pay on your checkout page.
  4. Click Save changes to apply the changes.

Here is a complete list of available settings:

  • Enable/Disable: Toggle to enable or disable Apple Pay and Google Pay on your checkout page.

  • Title: Change the display label of the payment method on the checkout page.

  • Payment Request Button Action: Choose the text displayed on the payment button. Possible values: Buy, Donate, Pay.

  • Payment Request Button Theme: Select the colour theme of the payment button. Possible values: Dark, Light, Light-Outline.

  • Payment Request Button Radius: Set the border radius of the payment button. Possible values: None, Small, Large.

  • Payment Request Button Size: Choose the size of the payment button. Possible values: Large, Small.

  • Payment Request Button Locations: Determine where the payment button appears. You can select multiple options: Product, Cart, Checkout.

    info

    The Product and Cart locations are for the Fast checkout feature. For more information, see: Features: Fast checkout.

caution

Remember to click the Save changes button to apply changes.

Card payments

The Credit/Debit Cards tab allows you to turn on or off the card gateway, which toggles the availability of Revolut Card widget on your checkout page.

This option allows customers to use card payments during checkout if enabled. If disabled, this payment option will not appear at checkout.

WooCommerce - Revolut Pay settings

To enable Card payments:

  1. Log in to your WooCommerce dashboard as an admin.
  2. Go to Plugins > Installed Plugins > Revolut Gateway for WooCommerce > Settings > Credit/Debit Cards.
  3. Check the Enable/Disable checkbox to enable Apple Pay and Google Pay on your checkout page.
  4. Click Save changes to apply the changes.

Here is a complete list of available settings:

  • Enable/Disable: Toggle to enable or disable card payments on your checkout page.
  • Title: Change the display label of the payment method on the checkout page.
  • Card Widget Type: Choose the type of the card payment widget. Possible values:
    • Card Field: Customers enter their card details directly on your checkout page in a card field.
    • Pop-up: A pop-up window appears for customers to enter their card details.
  • Save Cards: Enable this checkbox to allow customers to save their card details for future purchases.
Additional settings for Card field widget:
  • Cardholder's Name Field: Control how the cardholder's name is collected during the checkout process.
    • Enabled: A separate field appears on the card widget to collect cardholder's name. This is useful if the cardholder's name is different from the customer's billing name (e.g., when the billing name contains non-Latin characters).
    • Disabled: Cardholder's name is collected from the checkout form.
  • Card Widget Style:
    • Customize Card Widget Style: Enable this checkbox to customise the appearance of the card widget.
      • Card Widget Background Color: Set the background color of the card widget.
      • Card Widget Font Color: Set the font color of the card widget.
      • Revolut Logo Theme: Choose the theme of the Revolut logo displayed on the card widget. Possible values: Dark, Light.
note

The additional settings are available only when the Card Widget Type is set to Card Field.

caution

Remember to click the Save changes button to apply changes.

Additional settings

Advanced settings

In the Advanced Settings tab, you can manage additional plugin options.

WooCommerce - Advanced settings

  • Clear Unused Orders Now: Use this feature to delete unused orders from your database. Clicking the Clear button will remove unused order IDs stored in your website's database.
warning

This action could delete orders that customers have not yet paid but intend to. Make sure to use this feature when there are no active visitors on your website. You must acknowledge the risk by ticking the confirmation checkbox before proceeding.

Disable WooCommerce Blocks

Follow these steps to turn off WooCommerce Blocks and switch back to classic checkout:

  1. Log in to your WooCommerce dashboard as admin.

  2. Navigate to Pages and open the Checkout page with the editor.

  3. Scroll down to the Payment options section and select the block.

  4. On the right side panel, switch to the Block tab.

  5. Click Switch to classic checkout button and save your changes.

    WooCommerce - Disable Blocks feature

Test your configuration

After configuring the plugin, you can start testing payments using our test cards if you're in Sandbox mode.

note

Use your Sandbox API Secret key in Sandbox mode.

Start accepting payments

Once you're satisfied with your configuration and testing, switch to Live mode to start accepting real payments in your WooCommerce store.

note

Use your Production API Secret key in Live mode.


success

You're all set! Your WooCommerce store is now configured to accept payments via Revolut.

Was this page helpful?