Adding Paddle as a Payment Option<\/h2>\n\n\n\n
Follow the steps below to add the Paddle payment gateway to your Tutor LMS website:<\/p>\n\n\n\n
- \n
- Log in to your Tutor LMS WordPress Dashboard.<\/li>\n\n\n\n
- Navigate to Tutor LMS Pro > Settings > Monetization > Payment Methods<\/strong>.<\/li>\n\n\n\n
- Click on the Add New Gateway<\/strong> button.<\/li>\n\n\n\n
- From the list of available payment methods, select Paddle and click the Install button.<\/li>\n<\/ul>\n\n\n\n
Once installed, Paddle will appear as one of your payment options on the Payment Methods<\/strong> page.<\/p>\n\n\n\n
![\"Enable](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/04\/Enable-Paddle-for-Tutor-LMS.jpg\")
<\/figure>\n\n\n\nNote:\u00a0<\/strong>You’ll need an active\u00a0Tutor LMS Pro<\/a>\u00a0subscription to use the Paddle payment gateway.<\/p>\n\n\n\n
Configuring Paddle Integration<\/h2>\n\n\n\n
In the Payment Methods<\/strong> section, toggle the switch to enable Paddle for checkout. Then, click the Setup<\/strong> icon next to Paddle to expand the settings. Here, you can select the Environment<\/strong> and enter your Paddle credentials. It includes API Key, Client-side Token, and Webhook Secret Key.<\/p>\n\n\n\n
How to get Paddle’s Credentials?<\/h2>\n\n\n\n
You\u2019ll need Paddle’s credentials to integrate it with Tutor LMS. If you don\u2019t have an existing Paddle account, you must create a new account<\/a> first. Then log in to your account and collect your credentials. Here is the step-by-step process to get Paddle\u2019s credentials:<\/p>\n\n\n\n
Step 1: Generate API Keys<\/h3>\n\n\n\n
- \n
- Log in to your Paddle dashboard<\/a>.<\/li>\n\n\n\n
- Navigate to Paddle Dashboard > Developer Tools > Authentication<\/strong>. There, you will get a default API key from Paddle.<\/li>\n<\/ul>\n\n\n\n
![\"Paddle](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/04\/Paddle-API-Keys-scaled.jpg\")
<\/figure>\n\n\n\nNote:<\/strong>\u00a0Generate a new API key instead of using the default one for better security.<\/p>\n\n\n\n
You can generate a new API key from the \u201cGenerate API Key<\/strong>\u201d button.<\/p>\n\n\n\n
![\"Generate](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/04\/Generate-new-API-key-from-Paddle.jpg\")
<\/figure>\n\n\n\nTo generate an API key, you need to provide the API Key Name, Description, Expiry Date, and select the appropriate permissions. Please choose the specific permissions you want to grant through this API key.<\/p>\n\n\n\n
![\"Set](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/06\/Paddle-API-Key-permission.png\")
<\/figure>\n\n\n\nStep 2: Generate Client-side Token<\/h3>\n\n\n\n
Similar to generating the API key, you\u2019ll also need to generate a client-side token. Just click the \u201cGenerate client-side token<\/strong>\u201d button, enter a token name and description, and you’re done \u2014 your unique client-side token will be ready.<\/p>\n\n\n\n
![\"generate-client-side-token\"](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/04\/generate-client-side-token.jpg\")
<\/figure>\n\n\n\nStep 3: Set up Instant Notification System (INS)<\/h3>\n\n\n\n
Now you have to set up the webhook to get payment-related notifications. It is required for order processing and automatic renewals. Here is the process of configuring INS:<\/p>\n\n\n\n
- \n
- Navigate to Paddle Dashboard > Developer Tools > Notifications<\/strong>.<\/li>\n\n\n\n
- Click on the New Destination<\/strong> button.<\/li>\n<\/ul>\n\n\n\n
![\"Add](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/04\/Configure-notification-settings.jpg\")
<\/figure>\n\n\n\n<\/p>\n\n\n\n
- \n
- Now, enter the description and select Webhook<\/strong> as the Notification type. Then, copy the Webhook URL from the Tutor LMS plugin settings and paste it into the URL field. Then select the API version 1 and Usage type as Platform only<\/strong>.<\/li>\n<\/ul>\n\n\n\n
![\"Notification-destination-of-paddle\"](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/04\/Notification-destination-of-paddle.jpg\")
<\/figure>\n\n\n\n<\/p>\n\n\n\n
<\/span>The destination URL will be like this:https:\/\/round-lake.dustinice.workers.dev:443\/https\/YourDomain.com\/wp-json\/tutor\/v1\/ecommerce-webhook?payment_method=paddle<\/code><\/div><\/div><\/div>\n\n\n\n- \n
- Up next, you need to select the appropriate events for which you want to be notified. However, it\u2019s mandatory to select the following events for Tutor LMS:\n
- \n
- Transaction.completed<\/li>\n\n\n\n
- Adjustment.created<\/li>\n\n\n\n
- Adjustment.updated<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- Then, click on the Save Destination <\/strong>button.<\/li>\n<\/ul>\n\n\n\n
Finally, find your new destination, click the three-dot menu, and select Edit Destination<\/strong>. There, you will get a new field titled \u201cSecret key<\/strong>\u201d. You need to copy this key and paste it into Tutor LMS’s Webhook Secret Key<\/strong> field.<\/p>\n\n\n\n
![\"copy](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/04\/Webhook-secret-key-1024x693.jpg\")
<\/figure>\n\n\n\nStep 4: Approve Your Website Domain<\/h3>\n\n\n\n
To use Paddle checkout and use the Inline Checkout feature, you must first approve your domain. Without domain approval, you won\u2019t be able to process transactions directly on your website.<\/p>\n\n\n\n
To do so, navigate to the Paddle Dashboard > Checkout > Website Approval<\/strong>. From this page, you can add a new domain for verification.<\/p>\n\n\n\n
![\"Add](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/04\/Paddle-Domain-verification.jpg\")
<\/figure>\n\n\n\nIn the input field, enter your domain or subdomain URL without the http:\/\/ prefix or any trailing slashes. For example: <\/p>\n\n\n\n
\u2705 themeum.com<\/p>\n\n\n\n
\u2705 docs.themeum.com<\/p>\n\n\n\n
\u274c https:\/\/round-lake.dustinice.workers.dev:443\/https\/themeum.com\/<\/p>\n\n\n\n
Finally, click Submit for Approval<\/strong> button to complete the process.<\/p>\n\n\n\n
Step 4: Set the Default Payment Link<\/h3>\n\n\n\n
In the final step, you have to set the default payment link.You can do it by navigating to Paddle Dashboard > Checkout > Checkout Settings<\/strong>. Then scroll down a little bit, and you\u2019ll get the payment link input field in the Checkout settings page<\/a>.<\/p>\n\n\n\n
![\"Set-Default-payment-link\"](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/04\/Set-Default-payment-link.jpg\")
<\/figure>\n\n\n\nThen input your website URL<\/strong> here and save changes.<\/p>\n\n\n\n
Configuring Paddle Settings in Tutor LMS<\/h2>\n\n\n\n
Now, navigate to the Paddle configuration section and follow the steps below:<\/p>\n\n\n\n
- \n
- Choose between Sandbox or Live Environment, depending on whether you want to process real transactions or run test payments.<\/li>\n\n\n\n
- Input the Paddle API Key and Client-side token by collecting them from the Paddle Authentication<\/a> page. <\/li>\n\n\n\n
- Then, input the Webhook Secret Key by collecting it from the Paddle Notification<\/a> page.<\/li>\n\n\n\n
- Finally, click Save Changes<\/strong> to finalize your Paddle integration.<\/li>\n<\/ol>\n\n\n\n
![\"Enter](\"https:\/\/round-lake.dustinice.workers.dev:443\/https\/docs.themeum.com\/wp-content\/uploads\/2025\/04\/Input-paddle-api-keys.jpg\")
<\/figure>\n\n\n\nYou\u2019re done! Paddle is now ready to handle payments securely from your students.<\/p>\n\n\n\n
Note:<\/strong>\u00a0Paddle uses its own tax calculation method. So, taxes from your Tutor LMS courses will not be applied when the Paddle payment gateway is chosen. However, if you are VAT-registered, you can enter your VAT ID during checkout on the Paddle page.<\/p>\n","protected":false},"author":147377,"featured_media":0,"menu_order":0,"template":"","format":"standard","meta":[],"docs-category":[2002],"docs-tags":[],"class_list":["post-491516","docs","type-docs","status-publish","format-standard","hentry","docs-category-payment-gateways"],"_links":{"self":[{"href":"https:\/\/round-lake.dustinice.workers.dev:443\/https\/tutorlms.com\/wp-json\/wp\/v2\/docs\/491516","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/round-lake.dustinice.workers.dev:443\/https\/tutorlms.com\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/round-lake.dustinice.workers.dev:443\/https\/tutorlms.com\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/round-lake.dustinice.workers.dev:443\/https\/tutorlms.com\/wp-json\/wp\/v2\/users\/147377"}],"wp:attachment":[{"href":"https:\/\/round-lake.dustinice.workers.dev:443\/https\/tutorlms.com\/wp-json\/wp\/v2\/media?parent=491516"}],"wp:term":[{"taxonomy":"docs-category","embeddable":true,"href":"https:\/\/round-lake.dustinice.workers.dev:443\/https\/tutorlms.com\/wp-json\/wp\/v2\/docs-category?post=491516"},{"taxonomy":"docs-tags","embeddable":true,"href":"https:\/\/round-lake.dustinice.workers.dev:443\/https\/tutorlms.com\/wp-json\/wp\/v2\/docs-tags?post=491516"}],"curies":[{"name":"wp","href":"https:\/\/round-lake.dustinice.workers.dev:443\/https\/api.w.org\/{rel}","templated":true}]}}
- Then, input the Webhook Secret Key by collecting it from the Paddle Notification<\/a> page.<\/li>\n\n\n\n
- Up next, you need to select the appropriate events for which you want to be notified. However, it\u2019s mandatory to select the following events for Tutor LMS:\n
- Click on the New Destination<\/strong> button.<\/li>\n<\/ul>\n\n\n\n
- Navigate to Paddle Dashboard > Developer Tools > Authentication<\/strong>. There, you will get a default API key from Paddle.<\/li>\n<\/ul>\n\n\n\n
- Click on the Add New Gateway<\/strong> button.<\/li>\n\n\n\n