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


---

# 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://help.konnektive.com/konnektive-crm/admin-setup/plugins/authentication/paay-plugin.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.