> 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

<figure><img src="/files/nWAJa4yXObElrUSyM8IG" 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="/files/zdsmZelcl3lLCfOSr7Ii" 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="/files/Y4AyqWOtgq6lA9YMGNex" 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="/files/Jr7uPIxzcQaNOA9SdKar" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/SNNjVz4oD8sQQXOfcyEJ" 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="/files/E1gnIwnD7dabauadxHVf" 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="/files/50aPc1DR0TQuV2AGeo6T" 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="/files/5wITwhzRkz5dkEAsefXM" alt=""><figcaption></figcaption></figure>

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