Magento 2
Magento 2 is an open-source e-commerce platform developed by Adobe for creating online shops. With a dedicated plugin, the zahls.ch payment solution can be integrated into Magento 2.
General Information
Magento 2 is an open-source e-commerce platform developed by Adobe for creating online shops. With a dedicated plugin, the zahls.ch payment solution can be integrated into Magento 2.
The plugin is also compatible with the Magento Community Edition (Open Source).
Links
Features
- ✅ Multi-currency support
- ✅ Payment method logos displayed at checkout
- ✅ Shopping cart data transfer
- ✅ Webhook Compatibility
- ✅ Custom configuration of payment methods
- ❌ Hyvä Checkout (no dedicated zahls.ch module yet)
- ❌ Look & Feel Customization Options
- ❌ Subscription Support
Payment methods
The following payment methods are supported by the Magento 2 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 | |
| Pay by Bank | Apple Pay | WIRpay | |
| Purchase on Invoice | Google Pay | Barzahlen/viacash | |
| Crypto | Klarna | giropay | |
| eps | JCB | ||
| Bancontact | Paysafecash | ||
| iDEAL | Wero | Bitcoin | ||
| SEPA Debit Direct | Bill | ||
| POWERPAY | |||
| CembraPay | |||
| VERD |
Integration
Follow the instructions below to integrate zahls.ch into Magento 2.
Configuration of zahls.ch
-
In the dashboard area of your zahls.ch account, navigate to API & Plugins.
-
Click "Show all" under "Add E-Commerce Integration".
-
Next to Magento 2, click "Add".
-
In the window that appears below, configure 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 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://demo-shop.com), but instead in a subdirectory, make sure to enter the full path to your shop.
Example: https://demo-shop.com/shop
- Webhooks: Specify whether failed webhooks should be retried. If the checkbox is enabled, the system will attempt to resend the webhook up to 10 times.
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_PaymentGateway.zip.
- Open the /app/code/ directory in the Magento installation root (create
codeif it does not exist). - Extract the ZIP there so you get app/code/Zahls/PaymentGateway/.
Activating the extension
- Log in to the Magento 2 admin panel.
- Navigate to the root directory of your Magento 2 installation and execute the following commands.
$ bin/magento setup:upgrade
$ bin/magento setup:di:compile
$ bin/magento cache:clean
Configuration of Magento 2
- In the Magento 2 admin panel, navigate to Stores > Configuration > Sales > Payment Methods.
- Scroll down to the section "Other Payment Methods" and click the expand triangle icon.
- Open the section "Required Settings" and enter the values that were previously copied to your clipboard during the zahls.ch configuration.
- Instance Name: Enter the instance name provided by zahls.ch.
- API Secret Key: Enter the API key obtained from your zahls.ch account.