> For the complete documentation index, see [llms.txt](https://docs.payler.com/payler-public-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payler.com/payler-public-api/payler-e-commerce-plugins.md).

# Payler E-Commerce Plugins

## WooCommerce: Payler Payment Gateway

In this section, you can find how to set up and manage the *Payler Payment Gateway* plugin in WooCommerce in a few steps:

1. [Install Payler Payment Gateway](#install-payler-payment-gateway).
2. [Set up Payler Payment Gateway](#set-up-payler-payment-gateway).
3. [Manage Payler Payment Gateway](#manage-payler-payment-gateway).

### Install Payler Payment Gateway

Before setting up the Payler payment gateway in WooCommerce, make sure you have the *Payler Payment Gateway* plugin installed. There are two ways to install it:

* by finding and installing the *Payler Payment Gateway* plugin [from the *Wordpress plugins* directory](#install-the-plugin-from-the-wordpress-plugins-directory).
* [manually from the zip archive](#install-the-plugin-from-the-zip-archive), if you have one.

#### Install the plugin from the *Wordpress plugins* directory

You can add the *Payler Payment Gateway* plugin by downloading it from the *Wordpress plugins* directory. After opening [this page](https://wordpress.org/plugins/payler-payment-gateway) for the *Payler Payment Gateway* plugin, open and click *Download*. The downloaded plugin will be available as a zip archive that you can, [as described below](#install-the-plugin-from-the-zip-archive), install in the *WordPress admin dashboard*.

Alternatively, you can find and install the plugin directly in the *WordPress admin dashboard*. To do that:

1. In the *WordPress admin dashboard*, open the *Plugins -> Add New* page.
2. Find the *Payler Payment Gateway* plugin and click *Install Now*.
3. When the plugin is installed, click *Activate* to start using the plugin.

#### Install the plugin from the zip archive

To install the plugin from the zip archive, in the *WordPress admin dashboard*:

1. Open the *Plugins -> Add New* page.
2. Click *Upload Plugin* at the top of the page.
3. Click *Choose File* and find the *payler-payment-gateway.zip* on your local device.
4. After choosing the archive, click *Install Now*. When the plugin is installed, the *Plugin installed successfully* message will be displayed at the top of the page.
5. Click *Activate Plugin* to start using the *Payer Payment Gateway* plugin.

### Set up Payler Payment Gateway

Once you’ve installed the plugin, you can set it up. To do that, in the *WordPress admin dashboard*:

1. Open the *WooCommerce (1) -> Settings (2) -> Payments* *(3)* tab.
2. Find *Payler Payment Gateway* (4) on the list of payments and toggle on *Enabled* (5). It may require several seconds to switch on.
3. Click *Finish set up (6)*. The page with integration details will be opened.\ <br>

   <figure><img src="/files/s3b31ZvizjyREw1tWhiQ" alt=""><figcaption><p><br></p></figcaption></figure>
4. On the page with the integration details, specify the parameters:\
   \- *Enable Payler Payment Gateway:* tick or untick the checkbox to keep the Payler payment gateway enabled or disabled, respectively.\
   \- *Enable Test Mode:* the ticked checkbox means you’re running the Payler payment gateway in the test mode on a sandbox (<https://facade-api.neo.gate.paylerlab.com/gapi/v1/sessions>). In this case, provide the *Test Authorization Key* and *Test Authorization Password* in these integration details.\
   If the checkbox is not ticked, you’re running the Payler payment gateway on a live (production) environment (<https://facade-api.main.gate-api.com/gapi/payout/v1/sessions>). In this case, provide the *Live Authorization Key* and *Live Authorization Password* in these integration details.\
   \- *Title:* specify the title that your users will see during their checkouts.\
   \- *Description:* specify a description that your users will see during their checkouts. It could be any text.\
   \- *Test Authorization Key, Test Authorization Password:* specify these credentials if you’re running the Payler payment gateway in the test mode.\
   \- *Live Authorization Key, Live Authorization Password:* specify these credentials if you’re running the Payler payment gateway on a live (production) environment.
5. Click *Save changes* at the bottom of the page. If everything’s ok, the *Your settings have been saved* message will be displayed at the top of the page.\ <br>

   <figure><img src="/files/iLK8dN8ytNcE8GuHrgW3" alt=""><figcaption></figcaption></figure>

### Manage Payler Payment Gateway

At any point, you can change the settings of the enabled integration with the Payler payment gateway. To do that, in the *WordPress admin dashboard*:

1. Open the *WooCommerce (1) -> Settings (2) -> Payments* *(3)* tab.

2. Find *Payler Payment Gateway* (4) on the list of payments. If you’d like to disable the integration, toggle off *Enabled* (5). It may require several seconds to switch off.

3. To change integration settings, click *Manage* (6). The page with integration details will be opened.\ <br>

   <figure><img src="/files/VasyQYbOMCKNWkH0jprx" alt=""><figcaption></figcaption></figure>

4. On the page with the integration details, you can change [any of the settings mentioned above](#set-up-payler-payment-gateway). Change the needed settings and click *Save changes* at the bottom of the page. If everything’s ok, the *Your settings have been saved* message will be displayed at the top of the page.