[УКР](/Fys-8DgxT6SdUcnNO5G7tA) | ENG
:arrow_left: [Guide](/QA2NYRliRLGviJl5P4-ZCw)

# WordPress Plugin Settings

:::info
**Download:**
[Plugin from the "WordPress" library>>](https://wordpress.org/plugins/xpay-payment-gateway/)
[GitLab "WordPress">>](https://gitlab.com/xpaygroup/wordpress)
:::

## About Plugin

Free plugin **"XPAY Payment GateWay"** allows to integrate acceptance of payments via the XPAY system in shops developed on the WooCommerce platform.

## Plugin Functionality

* Setting up on the XPAY test environment with the possibility of switching to the product environment;
* Management of payment parameters without the need for programming;
* Choosing a client identifier when making a payment (mobile phone number or mail);
* Setting the redirection of the client's browser after making the payment to the specified page;
* Reception of "postback" with successful payment;
* Display of current payment status.

## Installation

To install the plugin, you need to go to the [**"Plugins"**](https://wordpress.org/plugins/) section, search for **"XPAY Payment GateWay"** and click on the **"Download" button "** to download a ZIP file with the appropriate name (XPAY Payment GateWay).


After receiving the file, go to the **"Plugins"** -> **"Add new"** section in the site administrator's panel and click the **"Download plugin"** button.


The next step is to activate the plugin. To do this, you need to go to the **"Plugins"** -> **"Installed"** section and find **"XPAY Payment GateWay"** among the list.


Plug-in activation can also be done directly during file upload, via the **"Activate Plug-in"** button in the next message after successful upload.


After activating the plugin, go to **"WooCommerce"** -> **"Settings"** section. Among the settings options, you must select **"Payments"**, find the **"XPAY"** method in the list and activate the check box.


To use the plugin and accept payments, you need to complete the configuration by clicking the **"Management"** button and go to the settings.


## XPAY Settings Options

* **Title** - the name of the payment method on the website;
* **Description** - a short description of the payment method on the website;
* **XPAY Service URL**:
- ``Test environment'' - https://stage-mapi.xpay.com.ua/uk/frame/widget/banner-payment
- ``Product environment'' - https://mapi.xpay.com.ua/uk/frame/widget/banner-payment
* **XPAY Public Key** - XPAY public key of the product or test environment for signature verification;
* **Open in new windows** - allows you to open the payment page in a new window;
* **Partner ID** - Partner identifier in the XPAY system;
* **User identified by** - client identifier, which determines how the store client will be identified in the XPAY system: by e-mail or mobile phone;
* **Return URL** - select the page to which the client's browser will be redirected after making the payment;
* **or manual link** - allows you to specify the URL of any resource to redirect the client's browser after payment;
* **Show Payment info** - indicates the need to display detailed payment information in the widget;
* **Payment item caption** - title of the order unit in the payment details in the widget;
* **Service URL for Pay request** - URL of the "postback" handler of the "pay" request on the store side. The "pay" request is sent by the XPAY system after a successful payment. Before starting work, you must provide XPAY with the address of the store's test and production environment.

## Order Processing

After completing all the settings for the client, when placing an order, the payment option via **"XPAY"** will be displayed on the website.

By clicking the **"Checkout"** button, the client will go to the payment page with order details and payment details.

Information about the current payment status is displayed in the **"Order"** section.