# 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:
## 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 %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.payrexx.com/merchant/english/integration/e-commerce/magento-2.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.