> For the complete documentation index, see [llms.txt](https://help.konnektive.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.konnektive.com/konnektive-crm/admin-setup/plugins/authentication/paay-plugin.md).

# PAAY Plugin

At PAAY, It's simple. We increase payment authorizations, reduce unnecessary chargebacks and seamlessly monitor for fraud.

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FZzZ7NtJXEhwlWjRsJk3t%2Fimage.png?alt=media&amp;token=11b67e72-525b-4baf-a0d3-3666814b2ec8" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
The PAAY plugin can be used to easily authenticate and protect transactions with external 3DS values. Add the PAAY plugin today to reduce chargebacks and start saving money!
{% endhint %}

{% hint style="warning" %}
Not compatible with Order-Entry/Phone campaigns.
{% endhint %}

### Billing for PAAY <a href="#billing-for-the-paay-plugin" id="billing-for-the-paay-plugin"></a>

The PAAY service is billed monthly at the time of your CRM subscription billing based on your plugin transaction rate (**RatePerTransaction**) per 3DS authentication attempt. If using the [PAAY 3RI plugin](https://help.checkoutchamp.com/crm/plugins/authentication/paay-3ri) then the billing for PAAY and PAAY 3RI are separate.

The current upcoming amount can be found in the Add-ons section on your Subscription page.

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2Frs9Yit0mkngVQjoHr78o%2Fimage.png?alt=media&amp;token=9abf3d31-7dfd-4535-b4a0-0b8d2681e93b" alt=""><figcaption></figcaption></figure>

### Adding PAAY <a href="#adding-the-paay-plugin" id="adding-the-paay-plugin"></a>

{% hint style="info" %}
A non-Dummy Gateway MID with filled in **MID #** and **Processor** fields is required for adding the PAAY plugin. You can go to **Gateways → Gateway List** to create a new gateway or to edit and update these fields on an existing one.
{% endhint %}

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FMNhJYtX1pFegMkRu7V5N%2Fimage.png?alt=media&amp;token=26577bd7-47d4-4e36-99fd-6388196273f8" alt=""><figcaption></figcaption></figure>

Merchant Details (**Merchants → MID List → Add/Edit**) required for adding/updating non-Dummy gateway MID for PAAY plugin creation

**Enabling the PAAY Plugin**

1. Go to **Admin → Plugins → Authentication**.
2. Click the PAAY tile.
3. Click **+ Activate**.
4. Enter a **Title**
5. Fill in **MCC, MID** and **Acquirer** from one of your CRM gateways
6. Click Connect.

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2F9smAUCe2ajdrRInokYeb%2Fimage.png?alt=media&amp;token=301247ae-9b88-4d33-a3e1-dba3be1817d3" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FXC1HjoaZRSs3Tdm5X7xE%2Fimage.png?alt=media&amp;token=6aea04b5-fe8f-436d-84ce-41862c2140da" alt="" width="307"><figcaption></figcaption></figure>

#### Troubleshooting Errors <a href="#troubleshooting-errors" id="troubleshooting-errors"></a>

Any errors that occur with adding the PAAY plugin will show in red at the top of the popup form.

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FoXzEz41YT7xwE6dKTuwX%2Fimage.png?alt=media&amp;token=c932fa24-c03f-4b24-a2a4-05fe85db5077" alt="" width="304"><figcaption></figcaption></figure>

{% hint style="info" %}
You can also view your CRM subscription billing information, click to edit your payment method, and access the PAAY dashboard when editing the plugin.
{% endhint %}

#### Rebills <a href="#rebills" id="rebills"></a>

Rebill authentication can be performed using the [PAAY 3RI plugin](/konnektive-crm/admin-setup/plugins/authentication/paay-3ri.md).

#### Trial Authentications <a href="#trial-authentications" id="trial-authentications"></a>

For trials, we recommend following these practices:

* **Hold Trial Charge** - Authenticate the cycle 2 transaction amount and send as the initial authentication amount. Do not attempt a PAAY rebill authentication.
* **Full Authorize & Void** and **Validate Card** Trials or any trial with either no cycle 1 price or only shipping for cycle 1 - Run the PAAY authentication using the cycle 2 transaction amount and then send to Konnektive as rebill 3DS parameters.

&#x20;

### Authenticating with PAAY on External Landers <a href="#authenticating-with-paay-on-external-landers" id="authenticating-with-paay-on-external-landers"></a>

#### Adding PAAY Javascript to Landing Pages <a href="#adding-paay-javascript-to-landing-pages" id="adding-paay-javascript-to-landing-pages"></a>

Follow the steps in [Authenticating with PAAY 3DS on Landers](/konnektive-crm/admin-setup/plugins/authentication/paay-plugin/authenticating-with-paay-3ds-on-landers.md) for adding PAAY Javascript to your landing pages.

#### Finding Your PAAY API Key <a href="#finding-your-paay-api-key" id="finding-your-paay-api-key"></a>

Once you have added the PAAY plugin, you can find your **paayApiKey** to use with the PAAY JavaScript you put on your lander by clicking on the PAAY tile (**Admin → Plugins → Authentication**).

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2Fk90TFyR2M4oPAgYOcWRH%2Fimage.png?alt=media&amp;token=3e7db94f-d1f2-42d9-86d7-f94e511112e2" alt=""><figcaption></figcaption></figure>

### PAAY Dashboard <a href="#paay-dashboard" id="paay-dashboard"></a>

The PAAY dashboard can be accessed by clicking on the **→ Dashboard** button from the plugin edit form. The PAAY dashboard is also available with a link at the top of the CRM dashboard.

If using both PAAY and 3RI plugins then use the between keys on the dashboard to see PAAY vs PAAY 3RI.

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FYth9J5O6AxZ74XH80YZH%2Fimage.png?alt=media&amp;token=87fedb69-573b-4f6d-b10b-9b3af730afa9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1103784913-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAC0G99SjXjSv2GM5PAE%2Fuploads%2FtnFLkmglZiyCS5QiparD%2Fimage.png?alt=media&amp;token=716c63b5-1cd1-460b-8f0a-be0f14ad52f4" alt=""><figcaption></figcaption></figure>