Before you start, make sure you have a verified Paddle account. If you don’t have one, go to Paddle's sign-up page to create and verify it.

Choose a Mode

Paddle has two modes:

  • Paddle Billing: This is the new and recommended version.

  • Paddle Classic: This is the older version.

If you are new to Paddle, your account will automatically use Paddle Billing.

Configuring Paddle Billing: Step-by-Step Guide

Setting up Paddle Billing is crucial for ensuring smooth transactions and enhanced security for your online business. Below, we break down the steps needed to configure Paddle Billing effectively.

Step 1: Access the Paddle Vendor Portal

  • Login to Your Account: Begin by signing into your Paddle Vendor Portal.

  • Navigate to Developer Tools: Once logged in, click on "Developer Tools" from the side menu.

  • Go to Authentication: Under Developer Tools, select the "Authentication" page.

Step 2: Gather Required Credentials

To proceed with the setup, you will need several key identifiers:

  • Copy the Seller ID: This unique identifier is essential for your account.

  • API Key: In the API keys section, either copy the Default API key or create a new one.

  • Client-side Token: In the Client-side tokens section, you can either copy the Default token or create a new one.

Step 3: Input Your Credentials

After gathering the necessary credentials:

  • Input your seller ID into the appropriate field in the plugin settings.

  • Paste the API key you copied or created into the designated field.

  • Similarly, input your client-side token.

 Please refer to the following image for better understanding.

Step 4: Configure Additional Settings

Once your credentials are entered:

  • Instant Notification System (INS)

  • Approve Your Website Domain

  • Add the Default Payment Link

Instant Notification System (INS) setup (Paddle Billing)

Setting up the Instant Notification System (INS) is essential for order processing and automatic renewals. Follow these streamlined steps to configure it efficiently:

Quick Steps to Configure INS

  1. Log In: Go to your Paddle Vendor Portal, and navigate to Developer Tools > Notifications.

  2. Create Destination: Click on New Destination.

  3. Enter Details:

  • Provide a brief description.

  • Choose Webhook as the notification type.

  • Paste the INS URL from your plugin settings into the URL field.

  1. Select Events: Pick the relevant options shown in the accompanying image.

  2. Save: Click Save Destination.

  3. Edit Destination: Find your new destination, click the three-dot menu, and select Edit Destination.

  4. Copy Secret Key: Retrieve and paste the Secret Key into your Plugin's Notification Secret Key field.

 

Please refer to the following image for better understanding.

Instant Notification System (INS) setup (Paddle Classic)

  • Navigate to Events: Go to Developer Tools > Events. 

  • Set INS URL: Paste the INS URL you received from the plugin under URLs for receiving webhooks.

  • Enable Webhook Events: Check all relevant webhook events for Subscription and One-off purchases and click Save.

Approve Your Website Domain

To launch your Paddle checkout and enable the Inline checkout feature, you must approve your domain. Without domain approval, processing transactions directly from your website won't be possible.

Quick Steps to Approve Your Domain

  1. Log In: Access your Paddle Vendor Portal.

  2. Navigate to Domain Approval: Go to Checkout > Website Approval.

  3. Add New Domain: Click on the Add a new domain button.

  4. Enter Domain: In the input field, enter your website link without the 'http://' prefix and any trailing '/'. For example, enter wordpress.test.

  5. Submit for Approval: Click Submit for Approval to finalize the process.

 

Refer to the accompanying image for a better understanding of these steps.

Setting Up the Default Payment Link in Paddle

Before launching your checkout, it's crucial to configure the Default Payment Link. This link is essential for processing payments on your site. Follow these concise steps to set it up:

Quick Steps to Set the Default Payment Link

  1. Log In: Access your Paddle Vendor Portal.

  2. Navigate: Go to Checkout > Checkout Settings.

  3. Enter URL: Input your website URL in the Default Payment Link field and press enter.

  4. Save: Click Save to store your settings.

 

Refer to the accompanying image for assistance with this process.

Paddle Classic (Legacy) 

Login and Auth Code Creation

  1. Login: Access your Paddle account.

  2. Get Vendor ID: Navigate to Developer > Authentication and copy your vendor_id.

  3. Create Auth Code: Click on Generate Key, name it for future reference, and copy the key after revealing it.

Retrieve Public Key

  • Copy Public Key: Go to the Public Key page and copy the full public key, including the lines:

```

-----BEGIN PUBLIC KEY-----

...

-----END PUBLIC KEY-----

```

  • All the new accounts use Paddle Billing API and It doesn't have a Public Key page but you can access it from here. Copy the Public Key from that page.