# nopCommerce

{% hint style="info" %}
Available for versions 4.10, 4.20, 4.30, 4.40, 4.50, 4.60, 4.70, 4.80
{% endhint %}

## General Information

With the open-source solution from nopCommerce, merchants can create powerful and scalable e-commerce systems. nopCommerce supports a wide range of features, including product catalogs, customer management, payment and shipping options, as well as multi-store and multi-vendor capabilities.

The Payrexx payment solution can be easily integrated into nopCommerce using the plugin developed by nopCommerce.

### Links

* NopCommerce [Website](https://www.nopcommerce.com/en)
* Download the [Plugin](https://www.nopcommerce.com/en/payrexx-payment-gateway)

{% hint style="info" %}
Please note that integration with nopCommerce is only available in the Standard and Premium plans. [For more information](https://payrexx.com/en/prices)
{% endhint %}

## Setup

### Plugin installation

* Open the [plugin download link](https://www.nopcommerce.com/en/payrexx-payment-gateway) on the nopCommerce website.
* Log in to your nopCommerce account.
* Download the plugin by clicking on "Get extension":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FYsJfysOHOiqXpuEBhuJn%2Fimage.png?alt=media&#x26;token=17248bed-d706-4438-b0c0-15b0fa7a5811" alt=""><figcaption><p>Downloading the plugin from the nopCommerce website</p></figcaption></figure></div>

* In your nopCommerce admin panel, navigate to **Configuration > Local Plugins**.
* Click on the green button "Upload plugin or theme":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FIgFrEEWEg1MgJ5O1BU44%2Fimage.png?alt=media&#x26;token=00cc2055-7556-4081-980e-cbdeb0f907e0" alt=""><figcaption><p>Uploading the plugin to nopCommerce (Step 1 of 2)</p></figcaption></figure></div>

* Select the previously downloaded plugin file (1) and upload it (2):

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F3ozuHbLqbLy57n7Qj39K%2Fimage.png?alt=media&#x26;token=cc46f16a-77c3-4543-9812-9a55ba184fb6" alt="" width="548"><figcaption><p>Uploading the plugin to nopCommerce (Step 2 of 2)</p></figcaption></figure></div>

* Locate the Payrexx plugin in the list of plugins.
* Click the "Install" button next to the plugin.

### Activating the plugin

* Search for the Payrexx plugin again in the list of plugins.
* Click the "Edit" button next to the plugin.
* In the newly opened window, enable the checkbox "Is enabled" (1) and click "Save" (2) to apply the changes:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FbbE9UDOOg4YoAnFvSqFj%2Fimage.png?alt=media&#x26;token=e2f141b0-88a4-46d1-82bd-a8c8838f1bb3" alt=""><figcaption><p>Configuring the plugin in nopCommerce</p></figcaption></figure></div>

* Do not close this browser tab. You will need it again in the next step when configuring the plugin.

### 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 main menu of your Payrexx account, navigate to **API & Plugins**.
* Under "Add E-Commerce integration", search for the nopCommerce plugin.
* Click on "Add":

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2Ft3Ntvunc0La01UuZsTmf%2Fimage.png?alt=media&#x26;token=f33afba9-bbc2-49b1-a59c-dc187a7d7e18" alt=""><figcaption><p>Adding the integration with nopCommerce</p></figcaption></figure></div>

* In the next window, complete the following steps:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2FCmKKxsJfDPzlQ7SGzFgl%2Fimage.png?alt=media&#x26;token=254af6d6-804f-4950-a357-ca8d7a805605" alt=""><figcaption><p>Configuring the integration with nopCommerce in Payrexx</p></figcaption></figure></div>

1. Copy the values from the "API Key" and "Instance name" fields into a text file for use in the next step.
2. Enter the URL of your webshop, for example: <https://examplecompany.com/shop>.
3. Click the green "Activate" button.

### Configuring nopCommerce

* Go back to the list of plugins in nopCommerce and click the "Configure" button next to the Payrexx plugin.
* Enter the previously copied details into the corresponding fields:

<div align="left"><figure><img src="https://1455115231-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MYJhU4qriZCz_Wxs0T0-887967055%2Fuploads%2F0zHhyVCmBcvIfqSKtp0J%2Fimage.png?alt=media&#x26;token=edc7ea30-c2fd-4d08-aa63-0c23802ffbee" alt="" width="496"><figcaption><p>Entering instance name and API key</p></figcaption></figure></div>

1. **Instance name:** This is the instance name of your Payrexx account. For example, if your account URL is *demo.payrexx.com*, your instance name is *demo*.
2. **API secret key:** This is the API key you copied in the previous step.

Click "Save" to complete the configuration.

{% hint style="success" %}
Payrexx is now successfully integrated with nopCommerce.
{% endhint %}