# 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. ![PrestaShop - Revolut Gateway: API settings](/img/accept-payments/plugins/prestashop/prestashop-api-settings.png 'PrestaShop - Revolut Gateway: API settings') 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. :::info - If you don't have a Revolut Business account, you can sign up [here](https://business.revolut.com/signup). - If you don't have a Revolut Pro account, you can sign up [here](https://www.revolut.com/revolut-pro/). ::: ## Connect your account To use the **Revolut Gateway for PrestaShop** plugin, you need to connect your Revolut Merchant account either by using OAuth or by entering your API key in the plugin's settings. :::note The plugin only supports API key connection in **Sandbox** mode. ::: - ![OAuth] ### Connect with OAuth OAuth provides an easier way to connect your Merchant account, follow these steps to directly connect your account: 1. **Log in** to your PrestaShop dashboard as an admin. 1. Navigate to **Modules > Module Manager**. 1. Find the **Revolut Gateway for PrestaShop** plugin and click **Configure**. 1. On the **API settings** tab, click **Connect your Merchant** account button. 1. You will be redirected to a login page, where you can give permission to PrestaShop to connect to your Merchant account. 1. Once completed, you can start accepting payments. - ![API key] ### Connect with API key To connect using your API key, you need to complete the following 2 steps. #### 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](https://sandbox-business.revolut.com/). 1. Navigate to the **:Cart: Merchant** overview. 1. Click **:Ellipsis:** and select [**:16/Code: Merchant API**](https://sandbox-business.revolut.com/settings/apis?tab=merchant-api). 1. If this is your first time here, click **Generate**. 1. Copy the **Sandbox API Secret key**. - ![Production API key] To use in the production environment: 1. **Log in** to your [Revolut Business account](https://business.revolut.com/). 1. Navigate to the **:Cart: Merchant** overview. 1. Click **:Ellipsis:** and select [**:16/Code: Merchant API**](https://business.revolut.com/settings/apis?tab=merchant-api). 1. If this is your first time here, click **Generate**. 1. Copy the **Production API Secret key**. ### Enter your API key in PrestaShop 1. **Log in** to your PrestaShop dashboard as an admin. 1. Navigate to **Modules > Module Manager**. 1. Find the **Revolut Gateway for PrestaShop** plugin and click **Configure**. 1. On the **API 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**. 1. Click **Save** to apply changes. :::tip You have successfully connected your Revolut Merchant account by providing your API key! ::: ## General configuration Under the **Settings** tab, you can configure general settings for the plugin. ![PrestaShop - Revolut Gateway: API settings](/img/accept-payments/plugins/prestashop/prestashop-api-settings.png 'PrestaShop - Revolut Gateway: API settings') - **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](https://business.revolut.com/settings/apis?tab=merchant-api) - [Sandbox](https://sandbox-business.revolut.com/settings/apis?tab=merchant-api) - **Connect your Merchant account:** Click this button to connect your Merchant account via direct login. - **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](/docs/guides/merchant/accept-payments/no-code/plugins/prestashop/features#manual-capture). ::: :::note Remember to click **Save** each time you update the configuration. ::: ## Enable payment methods ### 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. ![PrestaShop - Revolut Pay settings](/img/accept-payments/plugins/prestashop/prestashop-revolut-pay-settings.png 'PrestaShop - Revolut Pay settings') To enable Revolut Pay on your checkout page: 1. **Log in** to your PrestaShop dashboard as an admin. 1. Navigate to **Modules > Module Manager**. 1. Find the **Revolut Gateway for PrestaShop** plugin and click **Configure**. 1. On the **Revolut Pay** tab, set **Enable Revolut Pay?** to **Yes**. 1. Click **Save** to apply the changes. ### Apple Pay / Google Pay :::note Apple Pay and Google Pay are only available in **Live** mode. ::: The **Apple Pay / Google Pay** tab allows you to turn Apple Pay and Google Pay on or off for your checkout page and for **Fast checkout** on your **Product** and **Cart** pages. This option allows customers to use Apple Pay or Google Pay during checkout and during shopping if enabled. If disabled, these payment methods won't appear on your page. ![PrestaShop - Apple Pay and Google Pay settings](/img/accept-payments/plugins/prestashop/prestashop-apple-pay-google-pay-settings.png 'PrestaShop - Apple Pay and Google Pay settings') To enable Apple Pay and Google Pay: 1. **Log in** to your PrestaShop dashboard as an admin. 1. Navigate to **Modules > Module Manager**. 1. Find the **Revolut Gateway for PrestaShop** plugin and click **Configure**. 1. On the **Apple Pay / Google Pay** tab, set **Enable** to **Enabled**. 1. 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 Apple Pay and Google Pay buttons appear. Options: **Checkout**, **Product**, **Cart**. 1. Click **Save** to apply the 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. ![PrestaShop - Card settings](/img/accept-payments/plugins/prestashop/prestashop-card-settings.png 'PrestaShop - Card settings') To enable card payments on your checkout page: 1. **Log in** to your PrestaShop dashboard as an admin. 1. Navigate to **Modules > Module Manager**. 1. Find the **Revolut Gateway for PrestaShop** plugin and click **Configure**. 1. On the **Debit / Credit Card** tab, set **Enable Card Payments?** to **Yes**. 1. Choose the **Card Widget Type** as per your preference: - **Direct** - **Pop-up** - **Payment Page** - ![](/img/accept-payments/plugins/prestashop/prestashop-card-field.png) - ![](/img/accept-payments/plugins/prestashop/prestashop-card-pop-up.png) - ![](/img/accept-payments/plugins/prestashop/prestashop-card-payment-page.png) 1. Configure additional settings as needed: - **Title:** The display label for the card payment option on the checkout page. - **Description:** Optionally, add a description that's displayed if the card payment option is selected. - **Enable Cardholder name filed:** If enabled, an additional field is displayed with the card field to collect the cardholder name during checkout. If disabled, this is provided via the customer's personal information. 1. Click **Save** to apply the changes. ### Pay by Bank The **Pay by Bank** tab allows you to turn on or off the Pay by Bank gateway, which toggles the availability of Revolut Pay by Bank widget on your checkout page. This option allows customers to use their bank accounts for payments during checkout if enabled. If disabled, this payment option will not appear at checkout. ![PrestaShop - Pay by Bank settings](/img/accept-payments/plugins/prestashop/prestashop-pay-by-bank-settings.png 'PrestaShop - Pay by Bank settings') To enable **Pay by Bank**: 1. **Log in** to your PrestaShop dashboard as an admin. 1. Navigate to **Modules > Module Manager**. 1. Find the **Revolut Gateway for PrestaShop** plugin and click **Configure**. 1. On the **Pay by Bank** tab, set **Enable Pay by Bank** to **Yes**. 1. Click **Save** to apply the changes. :::info Before implementing Pay by Bank, be aware of the following: - **No sandbox environment:** Pay by Bank is not available in the sandbox environment. Real transactions must be made to test your implementation in the **production environment**. - **No refund support:** Pay by Bank does not support refunds through the Merchant API. If you need to refund a payment, you must process it through alternate channels outside of Revolut's payment system. - **Pricing restrictions:** Pay by Bank is not available for merchants on unblended pricing plans. ::: ## Additional settings ### Rewards & Promotions In the **Rewards & Promotions** tab, you can configure various promotional features and customer incentives for your Revolut Gateway integration. :::tip[Boost your conversions!] We recommend implementing the **Rewards & Promotions** widget. Analysis has shown that having the widget **can increase conversion to payment by ~5%**. ::: ![PrestaShop - Rewards and promotions settings](/img/accept-payments/plugins/prestashop/prestashop-rewards-promotions-settings.png) To configure these settings: 1. **Log in** to your PrestaShop dashboard as an admin. 1. Navigate to **Modules > Module Manager**. 1. Find the **Revolut Gateway for PrestaShop** plugin and click **Configure**. 1. On the **Rewards and Promotions** tab, toggle the desired options. 1. Click **Save** to apply the changes. These features help enhance the customer experience and promote the adoption of Revolut Pay on your PrestaShop store. Here is a complete list of available settings: - **Enable Revolut Reward banner:** Enable this option to display a banner inviting customers to join Revolut and receive exclusive rewards for signing up. The banner appears under the card widget during checkout and on the order confirmation screen. If customers sign up using the banner during checkout, a confirmation banner is displayed on the order confirmation page. If they haven't signed up during checkout, they have another opportunity to do so on the order confirmation page. Enabling this option allows customers to pay via Revolut Pay more efficiently on their next visit. - **Enable Revolut Pay benefits banner:** When enabled, this displays an informational banner describing the advantages of using Revolut Pay. The banner appears above the payment options on the checkout page or next to the Revolut Pay button as a fast checkout option. Customers can access a pop-up containing detailed information about the payment process and available benefits. - **Revolut Pay informational icon:** Configure how additional information about Revolut Pay is presented on your checkout page. Available options: - **Learn more:** Displays a "Learn more" text link that opens a pop-up explaining the benefits of Revolut Pay. - **Small icon:** Displays a compact informational icon that opens a pop-up with detailed benefits. - **Get cashback:** Displays a message about a cashback offer for new users. - **Disabled:** Removes the informational element from the checkout page. ### Advanced Settings ![PrestaShop - Revolut Gateway advanced settings](/img/accept-payments/plugins/prestashop/prestashop-advanced-settings.png) 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. - **Order Status for completed orders (webhook)**: Select the order status that will be assigned to orders confirmed to be completed via Revolut webhooks. By default, **Payment accepted** is selected. - **Order Status for completed orders**: Select the order status that will be assigned to orders completed on Revolut's side. By default, **Payment accepted** is selected. ## Test your configuration After configuring the plugin, you can start testing payments using our [test cards](/docs/guides/merchant/test-and-go-live/testing/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. 1. Navigate to **Modules > Module Manager**. 1. Find the **Revolut Gateway for PrestaShop** plugin and click **Configure**. 1. On the **Settings** tab, set **Mode** to **Sandbox**. 1. Enter your **Sandbox API Secret key** in the **API Key** field. 1. Ensure that the payment methods you wish to test are enabled. 1. Click **Save** to apply the changes. :::info Apple Pay and Google Pay are **not available** in Sandbox. ::: ## 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. 1. Navigate to **Modules > Module Manager**. 1. Find the **Revolut Gateway for PrestaShop** plugin and click **Configure**. 1. On the **Settings** tab, set **Mode** to **Live**. 1. Enter your **Production API Secret key** in the **API Key** field, or connect directly via the **Connect your Merchant account** button. 1. Click **Save** to apply the changes. :::tip You're all set! Your PrestaShop store is now configured to accept payments via Revolut. :::