How to Integrate PayLexer with WooCommerce
Connect PayLexer to WooCommerce to accept payments for your online store across multiple payment gateways.
Overview
WooCommerce is a WordPress plugin for online stores and e-commerce businesses. It lets you sell products, manage inventory, process orders and handle shipping directly from your WordPress site. PayLexer integrates with WooCommerce to handle secure payment processing across multiple gateways, such as Stripe, Airwallex, Square and more.
Supported Features
- One-time payments - Accept full payment for an order in a single transaction.
- Multiple payment gateways and websites - Connect and manage several gateways and websites from one PayLexer account.
- Test mode - Test payments safely without real charges before going live.
- Live payments - Process real transactions securely once setup is verified.
- Refunds - Process refunds directly from the WooCommerce admin panel, for gateways that support refunds.
Before You Start
Make sure you have the following before starting:
- Admin access to your WordPress site.
- WooCommerce installed and active. Download WooCommerce →
- 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 Airwallex. 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:
Getting Started
Complete the PayLexer setup. Setup guide →
Connect Your Website
Install the PayLexer plugin and select Connect Account. Connect your site →
Configure Payment Gateway
Choose and configure your gateway. Gateway docs →
Platform Integration
You're here! Continue below.
Test Transactions
Verify everything works. Test guide →
Integration Steps
You no longer add your website in PayLexer first or copy a Client ID and Site Key. The Connect Account button in the PayLexer plugin creates or signs in to your PayLexer account and adds your website automatically.
Install the PayLexer WordPress Plugin
- Go to WordPress Admin → Plugins → Add New Plugin.
- Search for PayLexer, then click Install Now.
- Click Activate to enable the plugin on your site.
Connect Your PayLexer Account
- In the WordPress sidebar, go to PayLexer. The General page opens with the Connect to PayLexer card.
- Click Connect Account and enter your email address. What happens next depends on your account:
- New to PayLexer: your account is created and your website is connected.
- Existing account: enter your password to sign in and connect.
- Already signed in on this browser: you skip the password and go to the authorization page. Check the account and website, then click Connect Account and Authorize.
You only connect once. Every gateway you configure in PayLexer runs through this connection.
Prefer to start from PayLexer? Add your website from Websites → Add Website, then finish with Connect Account in the plugin. See both ways to connect →
Check the Connection
- In WordPress, the card on the PayLexer General page changes to Connected to PayLexer with the status Active, and shows the email of your PayLexer account.
- On the same page, WooCommerce shows as Activated under Supported Integrations.
- In the PayLexer dashboard, go to Websites. Your website appears in the table with the status Connected.
On failure: Click Connect Account again and check the email and password you entered. Your website must show as Connected before payments can be processed.
Enable PayLexer Gateways in WooCommerce
- Go to WooCommerce → Settings → Payments.
- For each gateway you want to enable at checkout, click Manage.
- Check Enable/Disable and turn on Test Mode for initial testing.
- Click Save changes.
PayLexer now handles payment processing for your WooCommerce orders.
Customize Gateway Settings
Once a payment gateway is enabled, you can change how it appears to your customers at checkout. This works for every payment gateway. The steps below use Paddle as an example.
This is useful when you want to show a friendlier name to your customers. For example:
- Show "Credit Card" instead of "Paddle" or "Stripe", since most customers don't know the gateway name.
- Translate the label for your audience, such as "Tarjeta de crédito" for Spanish or "Carte bancaire" for French.
- Add a short description to guide customers during checkout.
Go to WooCommerce → Settings → Payments, find the gateway you want to update and click Manage.
You can update the following fields:
- Title - The name customers see when they choose a payment method at checkout. By default this is the gateway name, for example "Paddle". Change it to something your customers will recognize, like "Credit Card" or "Pay Online".
- Description - Optional text shown below the payment option on the checkout page. Use it to add helpful context, for example "Pay securely with your card."
Click Save changes to apply.
Test Mode
PayLexer supports full testing without real charges through WooCommerce's per-gateway Test Mode.
How Test Mode Works
- Go to WooCommerce → Settings → Payments.
- Find the gateway you want to test, for example Stripe via PayLexer, and click Manage.
- Turn ON Test Mode.
- Click Save changes.
When Test Mode is ON:
- PayLexer uses your Test credentials from the Payment Gateway Configuration page.
- WooCommerce orders are created normally.
- Payments are processed in test mode.
When Test Mode is OFF, PayLexer uses your Live credentials instead.
Test Mode is set separately for each gateway in WooCommerce. If you've enabled more than one PayLexer gateway, check the Test Mode setting on each one.
Payment Flow Overview
A new PayLexer order is created for every payment attempt.
Next Steps: Test Transactions
After enabling gateways, check the full payment flow before going live.
- Basic testing: Use WooCommerce's Test Mode above to create orders without real charges.
- Advanced testing (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.
- Monitor both the PayLexer and WooCommerce dashboards during the initial testing period.
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
- WooCommerce shows as Activated under Supported Integrations
- At least one gateway is added to your website
- At least one PayLexer gateway is enabled in WooCommerce
- Payment gateway tested successfully in Test Mode
- Live credentials added (not just test)
- Test Mode disabled on every PayLexer gateway in WooCommerce
FAQs
Still Have Questions?
Check the FAQs above first. If your question isn't covered there, choose the option that fits:
PayLexer Support
Site won't connect, gateways not showing at checkout, or orders stuck as pending? Open a ticket with the PayLexer team.
WooCommerce Support
Questions about products, orders, shipping or WooCommerce settings? Contact the WooCommerce team.
For settings and advanced configuration, see the WooCommerce documentation.