PrestaShop

In this article, you will learn how to install the official plugin for PrestaShop and connect Payrexx with your webshop.

Available for PrestaShop 8.0 - 9.x

General Information

PrestaShop is an open-source e-commerce platform that enables small and medium-sized businesses to create and manage their own online stores.

Links

• PrestaShop Website

• PrestaShop Documentation

• Plugin Download

Features

• ✅ Multi-currency support

• ✅ Payment method icons in checkout

• ✅ Cart transmission

• ✅ Webhook status synchronization

• ✅ Look & Feel configuration

• ✅ Individual payment method configuration

• ❌ Subscription support

Please note that integration with PrestaShop is only available in the Standard and Premium plans. For more information

Payment methods

The following payment methods are supported by the PrestaShop plugin:

Payrexx Pay	Payrexx Pay Plus	External Payment Providers
Mastercard	Mastercard	Masterpass
Visa	Visa	PayPal
PostFinance Pay	American Express	Maestro
TWINT	Diners Club International	HeyLight
Google Pay	Discover Card	Swissbilling
Samsung Pay	Apple Pay	WIRpay
Pay by Bank	Google Pay	Barzahlen/viacash
Purchase on Invoice	Klarna	giropay
Centi	eps	JCB
Crypto	Bancontact	Paysafecash
	iDEAL	Bitcoin
	WeChat Pay	Bill
	Alipay	POWERPAY
	SEPA Debit Direct	CembraPay
		VERD

Setup

Follow the instructions below to integrate Payrexx into PrestaShop.

Configuration of Payrexx

Make sure you're logged in to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can register now.

• Navigate to the API & Plugins section in the merchant administration of your Payrexx account.

• Click on "Show All" below "Add E-Commerce Integration".

• Click on "Add" next to PrestaShop:

Configuration of PrestaShop in Payrexx

• In the window below, apply the following settings:

Configuring the connection between PrestaShop and Payrexx

1. API Key: Copy the displayed API key to your clipboard, as you will need it later.

2. Instance Name: Copy the displayed instance name to your clipboard, as you will also need it later.

3. Enter shop address: In this field, enter the URL of your shop. If your shop is not located in the root directory (e.g., https://my-shop.com) but in a subdirectory, please enter the full path to your shop. Example: https://my-shop.com/shop

Please ensure that the shop URL is entered correctly. Any discrepancies (e.g. using http:// instead of https://) may cause errors when processing webhooks.

1. Webhooks: Define whether a failed webhook should be retried. If the checkbox is activated, the system will attempt to resend the webhook up to 10 times. The retry intervals are as follows: 5 minutes, 15 minutes, 1 hour, 2 hours, 4 hours, and then every 24 hours.

2. Finalize: Click the green "Activate" button to complete the configuration.

Plugin installation

• Download the latest version of the plugin from GitHub:

Download the ZIP file from GitHub

• Extract the file prestashop-payrexx-gateway-master.zip.

• Open the folder containing the payrexx subfolder and the .gitignore file.

• Compress the payrexx folder into a ZIP file.

• Log in to your PrestaShop account.

• Navigate to Modules > Module Manager.

• Click on the button.

• Upload the ZIP file of the plugin.

Configuration of PrestaShop

• Navigate to Modules > Module Manager.

• Set the Category field filter to "Payment":

Showing the payment modules

• Scroll down to Payrexx and click "Settings":

Accessing the Payrexx module settings

PrestaShop can be connected to Payrexx in two ways – automatically or manually:

Automatically connect PrestaShop to Payrexx

• Click the "Connect With Platform" button to establish the connection to Payrexx:

Automatic connection of PrestaShop and Payrexx

Manually connect PrestaShop to Payrexx

• Fill in the following fields to manually establish the connection to Payrexx:

Manual connection of PrestaShop and Payrexx

1. Payrexx Platform: Select the platform where your Payrexx account is located.

2. API Secret: Enter the API key that was generated during the configuration of Payrexx.

3. Instance Name: Enter the instance name of your Payrexx account. The instance name corresponds to the first part of your Payrexx URL. For example, if your URL is example.payrexx.com, the instance name is example.

4. Look and Feel Profile ID: Optionally, enter the ID of the desired Look & Feel profile.

The connection between Payrexx and PrestaShop has been successfully established.

• Navigate to Advanced Parameters > Performance.

• In the "Smarty" section, ensure that the option "Recompile templates if the files have been updated" is selected next to "Template compilation":

Template compilation settings in PrestaShop

Configuration of Payment Methods

In this section, you will learn how to configure the payment methods available for your customers in your PrestaShop store.

• Navigate to Modules > Module Manager.

• Scroll down to the "Payment Methods" section.

• Select the payment methods you want to enable:

Management of payment methods in PrestaShop

Order from the Customer’s Perspective

The following steps illustrate how a customer places and pays for a product on a website using PrestaShop with the integrated Payrexx payment solution:

The customer selects a product and adds it to the cart:

Selecting the product "Hummingbird printed sweater"

The customer clicks the “Proceed to checkout” button:

Proceed to checkout

The customer fills in the required fields and accepts the terms and conditions and privacy policy:

Filling in the form fields and accepting the terms and conditions

The customer selects "Payrexx" under "Payment", and the payment methods enabled in Payrexx appear – in this example: Mastercard, Visa, Purchase on Invoice, and TWINT:

Selecting Payrexx

The customer completes the order on the website by:

1. choosing one of the available payment methods (e.g., Visa)

2. accepting the terms of service

3. clicking "Place order"

Selecting the payment method Visa

The customer is then redirected to Payrexx to complete the order:

Completing the order on Payrexx

After completing the order, the customer is redirected back to the website, where the order and payment confirmation is displayed:

Order confirmation displayed in the webshop

The order is now successfully completed.

Place your own test order

If you want to see how an order works from the customer’s perspective, visit our demo shop and place a test order.

For more information and test credit card details, please refer to the following article:

Testing