PrestaShop

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.

Features

✅ Multi-currency support
✅ Payment method icons in checkout
✅ Cart transmission
✅ Webhook status synchronization
✅ Look & Feel configuration
✅ Individual payment method configuration
❌ Subscription support

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
Crypto	eps	JCB
	Bancontact	Paysafecash
	iDEAL \| Wero	Bitcoin
	WeChat Pay	Bill
	Alipay	POWERPAY
	SEPA Debit Direct	CembraPay
		VERD

Setup

Follow the instructions below to integrate zahls.ch into PrestaShop.

Configuration of zahls.ch

Navigate to the API & Plugins section in the dashboard of your zahls.ch account.
Click on "Show All" below "Add E-Commerce Integration".
Click on "Add" next to PrestaShop.
In the window below, apply the following settings.

API Key: Copy the displayed API key to your clipboard, as you will need it later.
Instance Name: Copy the displayed instance name to your clipboard, as you will also need it later.
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

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.
Finalize: Click the green "Activate" button to complete the configuration.

Plugin installation

Download the latest plugin: zahls.zip (release on GitHub).
Log in to your PrestaShop account.
Navigate to Modules > Module Manager.
Click on the button.
Upload the zahls.zip file.

Configuration of PrestaShop

Navigate to Modules > Module Manager.
Set the Category field filter to "Payment".
Scroll down to zahls.ch and click "Settings".

PrestaShop can be connected to zahls.ch in two ways – automatically or manually:

Automatically connect PrestaShop to zahls.ch

Click the "Connect With Platform" button to establish the connection to zahls.ch.

Manually connect PrestaShop to zahls.ch

Fill in the following fields to manually establish the connection to zahls.ch.

zahls.ch Platform: Select the platform where your zahls.ch account is located.
API Secret: Enter the API key that was generated during the configuration of zahls.ch.
Instance Name: Enter the instance name of your zahls.ch account. The instance name corresponds to the first part of your zahls.ch URL. For example, if your URL is example.zahls.ch, the instance name is example.
Look and Feel Profile ID: Optionally, enter the ID of the desired Look & Feel profile.

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".

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.

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 zahls.ch payment solution.

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

The customer clicks the “Proceed to checkout” button.

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

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

The customer completes the order on the website by:

choosing one of the available payment methods (e.g., Visa)
accepting the terms of service
clicking "Place order"

The customer is then redirected to zahls.ch to complete the order.

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

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