# 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.


---

# 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.payler.com/payler-public-api/payler-e-commerce-plugins.md?ask=<question>
```

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.