How to Integrate PayLexer with Tutor LMS

Connect PayLexer to Tutor LMS to accept course payments and subscription renewals across multiple payment gateways.

Overview

Tutor LMS is a WordPress plugin for creating, selling and managing online courses. PayLexer for Tutor LMS is PayLexer's own add-on for it. It adds every gateway you connect in PayLexer, such as Stripe, PayPal and more, to Tutor LMS's native eCommerce checkout, each as its own payment method.

Supported Features

• One-time payments - Students pay for a course in a single transaction on the gateway's secure hosted page.
• Subscriptions (Tutor LMS Pro) - Bill Tutor LMS Pro subscription plans as PayLexer subscriptions, renewals included, with trials, enrollment fees and billing-cycle limits.
• Automatic enrollment - Students are enrolled as soon as the payment is confirmed.
• Refunds from Tutor LMS - Refund full or partial amounts from the Tutor LMS order. Refunds made in the gateway's own dashboard or the PayLexer dashboard, full or partial, are mirrored back to the order.
• One payment method per gateway - Each gateway you enable in PayLexer gets its own card, name, logo and on/off switch in Tutor LMS.
• Multiple payment gateways and websites - Connect and manage several gateways and websites from one PayLexer account.
• Test and Live mode per gateway - Test payments safely without real charges before going live.

Before You Start

Make sure you have the following before starting:

• Admin access to your WordPress site.
• Tutor LMS installed & active, with its native eCommerce turned on. Download Tutor LMS →
• Tutor LMS Pro, only if you want to sell subscription plans.
• The email address you want to use for PayLexer. If you don't have a PayLexer account yet, one is created for you while you connect.
• A payment gateway account, such as Stripe or PayPal. If you're new to PayLexer, you configure it after connecting your website. Choose and configure a gateway →

Setup Journey

If you haven't configured PayLexer yet, follow these steps in order before continuing:

Integration Steps

Selling Subscriptions

With Tutor LMS Pro, you can sell subscription plans through PayLexer. The gateway bills every renewal, PayLexer reports it, and the add-on records the renewal order in Tutor LMS so the student stays enrolled.

• Gateways that can bill subscriptions show Tutor's Supports Subscriptions badge in Tutor LMS → Settings → Payment Methods, and only those are offered at checkout for subscription plans.
• Free trials, enrollment fees and billing-cycle limits from the plan are passed to the gateway. If the chosen gateway can't run a trial or charge a fee, the student sees a message at checkout and can choose another payment method.
• Cancelling a subscription in Tutor LMS also cancels it at the gateway, so no further renewals are charged. The student keeps access until the paid period ends.
• Pauses, resumes, failed renewals and cancellations made at the gateway or in PayLexer update the Tutor LMS subscription automatically.

Customize Gateway Settings

Once a payment gateway is enabled, its card in Tutor LMS shows the gateway's name and logo at checkout. Each card has one setting:

• Environment - Choose Test to use the gateway's sandbox with your Test credentials, or Live to process real payments with your Live credentials. New cards start on Test.

Go to Tutor LMS → Settings → Payment Methods, open the card for the gateway you want to update, change the Environment, then click Save Changes.

[IMAGE: Tutor LMS Payment Methods settings showing a PayLexer gateway card with the Environment field]

Test Mode

PayLexer supports full testing without real charges through each gateway's Environment setting in Tutor LMS.

How Test Mode Works

1. Go to Tutor LMS → Settings → Payment Methods.
2. Open the PayLexer gateway card and set Environment to Test.
3. Click Save Changes.

When Environment is Test:

• PayLexer uses your Test credentials from the Payment Gateway Configuration page.
• Tutor LMS orders are created normally.
• Payments are processed in test mode.

When Environment is Live, PayLexer uses your Live credentials instead.

Payment Flow Overview

A new PayLexer order is created for every payment attempt, including each subscription renewal.

Next Steps: Test Transactions

After enabling gateways, check the full payment flow before going live.

• Basic testing: Set each gateway's Environment to Test above and enroll in a course without real charges.
• Advanced testing (subscriptions, refunds, multi-gateway): Follow the dedicated guide. Test Transactions & Platform Integration →

Troubleshooting

Best Practices

• Always test with Test credentials before switching to Live.
• Enable webhooks for better reliability and real-time payment event syncing.
• Run one small real payment after going live to confirm everything works end to end.

Final Checklist

Before going live, confirm all of the following:

• The Connected to PayLexer card shows Active in WordPress
• Your website shows as Connected in the PayLexer Websites table
• Tutor LMS shows as Activated under Supported Integrations
• PayLexer for Tutor LMS shows as Activated under Available Add-ons
• At least one gateway is added to your website
• At least one PayLexer gateway is switched on in Tutor LMS
• Payment gateway tested successfully with Environment set to Test
• Live credentials added (not just test)
• Environment set to Live on every PayLexer gateway card in Tutor LMS

FAQs

Still Have Questions?

Check the FAQs above first. If your question isn't covered there, choose the option that fits:

For settings and advanced configuration, see the Tutor LMS documentation.