Configure the PrestaShop plugin

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

To configure the plugin, navigate to the settings page in your PrestaShop admin panel.

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

Connect your account​

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

Get your API key​

Depending on whether you want to test in the Sandbox environment or go live, you will 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 PrestaShop​

1. Log in to your PrestaShop dashboard as an admin.

2. Navigate to Modules > Module Manager.

3. Find the Revolut Gateway for PrestaShop plugin and click Configure.

4. On the Settings tab, you will see fields to enter your API key:

   • Mode: Choose Sandbox or Live depending on whether you're testing or going live.
   • API Key: Enter your API key based on the selected Mode.

5. Click Save to apply changes.

General configuration​

Under the Settings tab, you can configure general settings for the plugin.

• Enable Card Payments: Set to Yes to enable card payments on your PrestaShop store.

• Enable Revolut Pay: Set to Yes to enable Revolut Pay on your PrestaShop store.

• Title: Enter the title displayed on the checkout page for the card payment method and select the corresponding localisation language.

• Description: Enter the description displayed for the card payment method on the checkout page and select the corresponding localisation language.

• Enable Cashback Reward Banner: Set to Yes if you want to display Revolut's promotional banner on your checkout to prompt customers to join Revolut and get rewards.

• Mode: Controls if the plugin 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.

• API Key: Depending on which mode you selected, provide the corresponding API secret key from your Merchant API settings:

  • Production
  • Sandbox

• Enable "Authorize Only" mode: Select the checkbox to only authorise payments and capture them later manually. Deselect the checkbox to capture payments automatically at the time of purchase.

  info

  For more information about capturing payment manually, see: Features: Manual capture.

• Card Widget Type: Choose the type of card payment widget:

  • Direct: The card widget will appear under the payment button on the checkout page.
  • Payment Page: Customers are redirected to a secure payment page after placing the order.
  • Popup: A pop-up window appears for customers to enter their card details.

• Order Status for Completed Order: Choose the status for an order to be considered completed on Revolut's side. By default, Payment accepted is selected.

Enable payment methods​

Revolut Pay​

To enable Revolut Pay on your checkout page:

1. Log in to your PrestaShop dashboard as an admin.
2. Navigate to Modules > Module Manager.
3. Find the Revolut Gateway for PrestaShop plugin and click Configure.
4. On the Settings tab, set Enable Revolut Pay to Yes.
5. Click Save to apply the changes.

Apple Pay / Google Pay​

To enable Apple Pay and Google Pay:

1. Log in to your PrestaShop dashboard as an admin.

2. Navigate to Modules > Module Manager.

3. Find the Revolut Gateway for PrestaShop plugin and click Configure.

4. On the Apple Pay / Google Pay tab, set Enable to Enabled.

5. Configure additional settings as needed:

   • Payment Request Button Action: Choose the text displayed on the payment button. Options: Buy, Pay, Donate.
   • Payment Request Button Theme: Select the colour theme of the payment button. Options: Dark, Light, Light-outlined.
   • Payment Request Button Radius: Set the border radius of the payment button. Options: None, Small, Large.
   • Payment Request Button Size: Choose the size of the payment button. Options: Large, Small.
   • Payment Request Button Locations: Select where the payment button appears. Options: Product, Cart.

6. Click Save to apply the changes.

Card payments​

To enable card payments on your checkout page:

1. Log in to your PrestaShop dashboard as an admin.

2. Navigate to Modules > Module Manager.

3. Find the Revolut Gateway for PrestaShop plugin and click Configure.

4. On the Settings tab, set Enable Card Payments to Yes.

5. Choose the Card Widget Type as per your preference:

   • Direct
   • Pop-up
   • Payment Page
   

   

   

   
   

6. Click Save to apply the changes.

Additional settings​

Advanced Settings​

On the Advanced Settings tab, you can configure additional options:

• Enable automatic refunds: With this option enabled, refunding an order in PrestaShop will trigger an event on Revolut's side. For example, by default if you make Partial refund or Product cancellation, an automatic refund will be issued on Revolut's side for the corresponding order and amount.
• Customize your order status: Set to Yes to customize order statuses for specific actions in the Revolut Gateway module.
  • Order Status for triggering the refund on Revolut: Select the order status that triggers a refund on Revolut. By default, Refunded is selected.
  • Order Status for triggering the capture on Revolut: Select the order status that triggers payment capture on Revolut. By default, Payment accepted is selected.

Test your configuration​

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

To test the plugin in the Sandbox environment:

1. Log in to your PrestaShop dashboard as an admin.
2. Navigate to Modules > Module Manager.
3. Find the Revolut Gateway for PrestaShop plugin and click Configure.
4. On the Settings tab, set Mode to Sandbox.
5. Enter your Sandbox API Secret key in the API Key field.
6. Ensure that the payment methods you wish to test are enabled.
7. Click Save to apply the changes.

Start accepting payments​

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

1. Log in to your PrestaShop dashboard as an admin.
2. Navigate to Modules > Module Manager.
3. Find the Revolut Gateway for PrestaShop plugin and click Configure.
4. On the Settings tab, set Mode to Live.
5. Enter your Production API Secret key in the API Key field.
6. Click Save to apply the changes.