# PAAY

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F4CqG0tZc2HoB5H4KQxxR%2Fimage.png?alt=media&#x26;token=0a0d9bc6-d4be-490e-b233-aaea4754b291" 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](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://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FBkpxHjGB537YvGao3UM1%2Fimage.png?alt=media&#x26;token=166fce2d-195f-4742-b233-d09257e6fc44" 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="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FHiBjfyxb59lD2JLqUoHV%2Fimage.png?alt=media&#x26;token=f7b34ae7-6c96-4fa0-ba4f-3f0886b22176" 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="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F7F9aAsijOwyvhNTnafV7%2Fimage.png?alt=media&#x26;token=6a9dcf06-82c2-46b3-8810-3aa7671521f9" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FoXbNbJiyW89qFW7W5Y0P%2Fimage.png?alt=media&#x26;token=e9c49f73-942f-442e-babb-0f431c8bce17" 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="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FIkgehy6f2Y8YLLolG0XH%2Fimage.png?alt=media&#x26;token=d8107db6-c38c-45c5-a7fb-10dd8325bb23" 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](https://help.checkoutchamp.com/crm/plugins/authentication/paay-3ri).

#### 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](https://help.checkoutchamp.com/funnel-builder/creating-and-editing-funnels-pages/funnel-visualizer-and-page-builder/funnel-visualizer/edit-funnel-settings/add-ons/paay-add-on)

* 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="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F0GZq50aVPWlgYfMCUDs7%2Fimage.png?alt=media&#x26;token=07f88cc7-c930-40e6-b70e-af6c40784d30" 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="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F8Fj4Rbdbp4mkdhPNObkt%2Fimage.png?alt=media&#x26;token=9437188a-8d7e-4c04-817d-0cdd64ad3394" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FYE7I3sdZK6rbJEjuzrUr%2Fimage.png?alt=media&#x26;token=eeb14285-6f79-4620-ab31-428a47203010" alt=""><figcaption></figcaption></figure>