# PAAY

<figure><img src="/files/IfL6M73TufPYSM8LEbeN" 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 %}

### Billing for PAAY <a href="#paayplugin-billingforthepaayplugin" id="paayplugin-billingforthepaayplugin"></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](/crm/plugins/authentication/paay-3ri.md) 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/uaaEH1jT41sKrt7PkNoM" alt=""><figcaption></figcaption></figure>

### Adding PAAY <a href="#paayplugin-addingthepaayplugin" id="paayplugin-addingthepaayplugin"></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/51Fqiiok2HEGt4p1t0a0" 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 <a href="#paayplugin-enablingthepaayplugin" id="paayplugin-enablingthepaayplugin"></a>

1. Go to **Admin → Plugins → Authentication**.
2. Click the PAAY tile.
3. Click **+ Activate**.
4. Enter a **Title**
5. Optionally whitelist **domains** on which PAAY will be used.  It is highly recommended to whitelist all your domains to prevent illegitimate use of your key.
6. Fill in **MCC, MID** and **Acquirer** from one of your CRM gateways
7. Click Connect.

<figure><img src="/files/QC7Bvo6cde29v90P4idJ" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/kQhefx5qWjp0HEXMh6k0" alt="" width="375"><figcaption></figcaption></figure>

#### Troubleshooting Errors <a href="#paayplugin-troubleshootingerrors" id="paayplugin-troubleshootingerrors"></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/sL1u9gDjTKCjT75Ux3Nz" 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 plugin dashboard when editing the plugin.
{% endhint %}

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

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

#### Trial Authentications <a href="#paayplugin-trialauthentications" id="paayplugin-trialauthentications"></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.

### Authenticating with PAAY on CheckoutChamp pages <a href="#paayplugin-authenticatingwithpaayoncheckoutchamppages" id="paayplugin-authenticatingwithpaayoncheckoutchamppages"></a>

Please follow this article after enabling the [PAAY plugin](/funnel-builder/creating-and-editing-funnels-pages/funnel-visualizer-and-page-builder/funnel-visualizer/edit-funnel-settings/add-ons/paay-add-on.md)

* Publish your funnel after entering the PAAY key
* Card Month and Card Year must be separate inputs on your checkout page

#### Finding Your PAAY API Key <a href="#paayplugin-findingyourpaayapikey" id="paayplugin-findingyourpaayapikey"></a>

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

<figure><img src="/files/pCIQ4KJlErPqmEIUJ9WJ" alt="" width="303"><figcaption></figcaption></figure>

### PAAY Dashboard <a href="#paayplugin-paaydashboard" id="paayplugin-paaydashboard"></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.

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

<figure><img src="/files/X0dvSRlvl8baIIgltOlq" 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.checkoutchamp.com/crm/plugins/authentication/paay.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.