Quick Setup Guide

Paddle Configuration

Login to your Paddle Vendor Dashboard at https://vendors.paddle.com

From the left sidebar, choose Checkout > Website Approval

Click on Add a new domain and add your WHMCS domain, or subdomain

For example: if your WHMCS is hosted at billing.domain.com, enter that. Otherwise if it is hosted at domain.com/billing then enter domain.com and click on the Submit For Approval button

Subdomain	Directory
billing.domain.com	domain.com

Then, from the left sidebar, choose Checkout > Checkout Settings

Set the Default payment link as below and save

For example: if your WHMCS is hosted at billing.domain.com, enter https://billing.domain.com/viewinvoice.php . Otherwise if it is hosted at domain.com/billing then enter https://domain.com/billing/viewinvoice.php

Subdomain	Directory
https://billing.domain.com/viewinvoice.php	https://domain.com/billing/viewinvoice.php

Then, from the left sidebar, choose Checkout > Sales Tax Settings

Select the Sales Tax Setting required and press Save Changes

Then, from the left sidebar, choose Developer Tools > Authentication

Click on Generate API Key

Give it a familiar name, and press the Generate button, copy the key as you will need it later when configuring the payment module in WHMCS

Next, click on Generate client-side token

Give it a familiar name, and press the Generate button, copy the token as you will need it later when configuring the payment module in WHMCS

Then, from the left sidebar, choose Developer Tools > Notifications

Click on New Destination

Give it a familiar description, choose Webhook for notification type and for the URL it will be one of the below depending on your setup

Subdomain	Directory
https://billing.domain.com/modules/gateways/callback/paddlelayer.php	https://domain.com/billing/modules/gateways/callback/paddlelayer.php

Under Events, choose the below 3 Events

Press Save Destination.

Now, click the ... button and click on Edit destination

Now copy the Secret Key, this will be the 'Notification Secret Key' which you will need when you configure the module in WHMCS.

Everything is ready and configured on Paddle side.

WHMCS Configuration

• Download the latest .zip of the Paddle module file from the Layer client area - https://my.layer.ae

• Unzip the .zip file and place the contents into the WHMCS directory

• Login to the admin side of WHMCS, and go to Setup > Apps & Integrations (as below)

• Click on Browse, and then click on Payments under categories, and look for the Layer Paddle Billing module

• Click on Layer Paddle Billing, and then click on Activate

• Fill in your Layer license Key, your Paddle API Key (from the previous steps), your Paddle Client Side Token (from the previous steps) and your Notification Secret Key

• Select the currency to charge in (this should be an enabled currency in your paddle account)

• Select the Paddle Sales Tax Setting

• If your WHMCS has multiple currencies, you have to set "Convert To For Processing" to match the charge currency

Congratulations! Everything is ready for you now. You can create a test invoice, and go through the flow.

To use the sandbox mode, you need to register on the paddle sandbox environment at https://sandbox-vendors.paddle.com the steps are the same - you only need to enable sandbox mode in the module setting in WHMCS for the module to use Paddle's sandbox environment.