# Magento 2 {% hint style="info" %} Available for Magento 2.4 - 2.4.x {% endhint %} ## General Information Magento 2 is an open-source e-commerce platform developed by Adobe for creating online shops. With a dedicated plugin, the Payrexx payment solution can be integrated into Magento 2. The plugin is also compatible with the Magento Community Edition (Open Source). ### Links * Magento 2 [Website](https://business.adobe.com/uk/products/magento/open-source.html) * Plugin [Download](https://github.com/payrexx/magento-payrexx-gateway) ### Features * ✅ Multi-currency support * ✅ Payment method logos displayed at checkout * ✅ Shopping cart data transfer * ✅ Webhook Compatibility * ✅ Custom configuration of payment methods * ✅ [Hyvä Checkout Module](https://github.com/payrexx/hyva-payrexx-compatibility) Compatibility * ❌ Look & Feel Customization Options * ❌ Subscription Support {% hint style="info" %} Please note that integration with Magento 2 is only available in the Standard and Premium plans. [For more information](https://payrexx.com/en/prices) {% endhint %} ### Payment methods The following payment methods are supported by the Magento 2 plugin:
Payrexx PayPayrexx Pay PlusExternal 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
Centi Klarnagiropay
Crypto eps JCB
Bancontact Paysafecash
iDEAL Bitcoin
SEPA Debit Direct Bill
POWERPAY
CembraPay
VERD
## Integration Follow the instructions below to integrate Payrexx into Magento 2. ### Configuration of Payrexx {% hint style="info" %} Make sure you're [logged in](https://login.payrexx.com/) to your Payrexx account before you begin. If you don’t have a Payrexx account yet, you can [register](https://signup.payrexx.com/) now. {% endhint %} * In the merchant administration area of your Payrexx account, navigate to **API & Plugins**. * Click "Show all" under "Add E-Commerce Integration". * Next to Magento 2, click "Add".

Start of Magento 2 integration

* In the window that appears below, configure the following settings:
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 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. ), but instead in a subdirectory, make sure to enter the full path to your shop.\ Example: {% hint style="warning" %} Please ensure that the shop URL is entered correctly. Any discrepancies (e.g. using http\:// instead of https\://) may cause errors when processing webhooks. {% endhint %} 4. **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. 5. **Finalize:** Click the green "Activate" button to complete the configuration. ### Plugin installation * Download the latest version of the [plugin](https://github.com/payrexx/magento-payrexx-gateway) from GitHub. * Open the **/app/** directory located in the root directory of your Magento installation. * Inside the **/app/** directory, create the following folder structure:\ **code/Payrexx/PaymentGateway/** * Extract the downloaded ZIP file into the **/PaymentGateway** directory. * Move all extracted files and folders into the **/PaymentGateway** directory. ### 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` {% hint style="warning" %} This process may take some time to complete. {% endhint %} {% hint style="info" %} For Magento versions older than 2.3, the extension can alternatively be activated via\ **System > Web Setup Wizard**. Further details can be found in the installation guide on GitHub. {% endhint %} ### 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 [Payrexx configuration](#configuration-of-payrexx):

Settings in Magento 2

1. **Instance Name:** Enter the instance name provided by Payrexx. 2. **API Secret Key:** Enter the API key obtained from your Payrexx account. {% hint style="info" %} Alternatively, the connection can be established just as easily by clicking the "Connect" button. {% endhint %} {% hint style="success" %} The configuration is complete. Your customers can now make payments in your Magento 2 shop using the payment methods provided by Payrexx. {% endhint %}