Before proceeding, ensure that you have a verified Paddle account. Our plugins require a verified Paddle account to function correctly. If you don’t have one yet, you can create and verify your account by visiting Paddle's sign-up page.

Paddle offers two modes: Paddle Billing and Paddle Classic.

  • Paddle Billing is the newer version and is recommended for use.
  • Paddle Classic is the older version of Paddle.

If you’re new to Paddle, your account will automatically be set to Paddle Billing.

Please follow the instructions below and take notes using your preferred note-taking app.

 

Paddle Billing

Please follow the steps below to configure Paddle Billing:

  1. Login to your Paddle Vendor Portal and navigate to the Developer Tools > Authentication page.
  2. Copy the seller ID.
  3. In the API keys section, copy the Default API key or create a new one and copy it.
    We recommend generating a new API key for enhanced security.
  4. In the Client-side tokens section, copy the Default token or create a new one and copy it.
    We recommend generating a new client-side token for enhanced security.
  5. Enter the copied data into their respective fields in the plugin settings.
  6. Then, follow the Instant Notification System (INS) setup (Paddle Billing) by clicking here.
  7. Then, Approve your website domain by clicking here.
  8. Finally, Add the Default Payment Link by clicking here.

Please refer to the following image for better understanding.

 

Instant Notification System (INS) setup (Paddle Billing)

To set up instant payment notifications, please follow the steps below:

  1. Login to your Paddle Vendor Portal and navigate to the Developer Tools > Notifications page.
  2. Click New Destination from the upper right corner of the page.
  3. Give a short description of the destination.
  4. Select Webhook in Notification type.
  5. Copy the INS URL from the plugin settings page and paste it into the URL field in Paddle.
  6. In the Events section, select the options shown in the following image.
  7. Click Save Destination from the upper right corner of the page.
  8. From the newly created destination, click the three-dot [...] menu and click Edit Destination.
  9. Copy the Secret Key from the edit page.
  10. Provide the Secret Key into the Plugin's Notification Secret key field.

Please refer to the following image for better understanding.

 

Default Payment Link

Before going live, make sure to set the Default Payment Link. Without this, you will not be able to use the checkout on your site. Please follow the steps below to set the Default Payment Link in Paddle:

  1. Login to your Paddle Vendor Portal and navigate to the Checkout > Checkout Settings page.
  2. Add your website URL into the Default Payment Link field and press enter.
  3. Click Save.

Please refer to the following image for better understanding.

 

Domain Approval

Before going live, make sure to approve the domain from which you plan to launch the Paddle checkout. Without approval, you will not be able to use the Inline checkout on your site. Please follow the steps below to approve your domain in Paddle:

  1. Login to your Paddle Vendor Portal and navigate to the Checkout > Website Approval page.
  2. Click Add a new domain.
  3. In the input field enter your website link and click Submit for Approval.
    Give link without 'http://' and any trailing '/'. Ex. wordpress.test

Please refer to the following image for better understanding.

 

Integrate VAT ID with Paddle Billing

Paddle for Woocommerce auto-fill the payment form with your user's details, like email, address, business name, and tax identifier. To pass Tax Identifier we use Billing VAT ID. Here is the meta_id for Billing VAT: _billing_vat_id If you are unsure about your field info, pass this meta_id to your developer to ensure you use the correct meta. 

 

Paddle Classic

  1. Login to your Paddle account
  2. Head over to Developer > Authentication page and copy the vendor_id
  3. Create a new Auth code. Give it a name so you can understand later and press Generate key button. You'll see newly create key, press Reveal Auth Code button and copy the key.
  4. Now head over to public key page and copy the public key AS IT IS. Copy the key including -----BEGIN PUBLIC KEY----- and -----END PUBLIC KEY----- line.
  • 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.

 

Instant Notification System (INS) setup (Paddle Classic)

 

  1. Head over to Developer tools > Events menu.
  2. Under URLs for receiving webhooks set the INS URL you received from the plugin.
  3. Enable all the webhook events listed under Subscription and One-off purchases and press Save.