How to Integrate PayLexer with WooCommerce

Connect PayLexer to WooCommerce to accept payments for your online store across multiple payment gateways.

WooCommerce is a WordPress plugin for online stores and e-commerce businesses. It enables you to 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 - 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 – Safely test payments 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.

Before You Start

Prerequisites

Make sure you have the following before starting:

Configured Payment Gateway – Choose & configure a gateway →
A PayLexer account. Create your account →
Admin access to your WordPress site.
WooCommerce installed and active. Download WooCommerce →

Setup Journey

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

Getting Started

Complete the PayLexer setup. Setup guide →

Configure Payment Gateway

Choose and configure your gateway. Gateway docs →

Add Your Website

Platform Integration

You're here! Continue below.

Test Transactions

Verify everything works. Test guide →

Integration Steps

Choose WordPress as the Platform

In the Add Website flow inside PayLexer:

Select WordPress as the platform.
Download the PayLexer WordPress plugin (.zip file).
Copy the credentials generated by PayLexer:
- Client ID
- Site Key

Install the PayLexer WordPress Plugin

Go to WordPress Admin → Plugins → Add Plugin.

Click Upload Plugin, choose the .zip file you downloaded, then click Install Now.

Click Activate to enable the plugin on your site.

Connect WordPress to PayLexer

Go to Settings → PayLexer in your WordPress admin.

Paste the Client ID and Site Key copied from PayLexer.
Click Save Changes.

This establishes the secure connection between WooCommerce and PayLexer.

Test the Connection

Back in PayLexer, return to the Add Website flow.
Click Test Connection.

Success: Your website shows as Connected.

On failure: Double-check the Website URL and the credentials pasted in WordPress. 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 enable Test Mode for initial testing.
Click Save Changes.

PayLexer will now handle payment processing for WooCommerce orders.

Customize Gateway Settings

Once a payment gateway is enabled, you can customize how it appears to your customers at checkout. This applies to all payment gateways - 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" - most customers do not know the gateway name
Translate the label for your audience - "Tarjeta de crédito" for Spanish, "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 shown to customers when they choose a payment method at checkout. By default this is the gateway name (e.g., "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 this 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 via WooCommerce's per-gateway Test Mode.

How Test Mode Works

Go to WooCommerce → Settings → Payments.
Click on the gateway you want to test (e.g., Stripe via PayLexer).
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.

Payment Flow Overview

A new PayLexer order is created for every payment attempt.

Next Steps: Test Transactions

After enabling gateways, validate 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

Client ID or Site Key mismatch - re-copy credentials from PayLexer and paste again.
Plugin not activated - confirm the PayLexer plugin shows as Active in WordPress.
Wrong website selected in PayLexer - ensure you're testing the correct site.

Gateway not enabled in PayLexer - check your Payment Gateway Configuration page.
No payment method enabled in WooCommerce - verify the Payments settings in WooCommerce.
Test Mode not properly configured - confirm credentials match the current mode.

Webhooks not configured - enabling webhooks is recommended for reliable order status updates.
Payment gateway credentials are incorrect - verify them in your PayLexer configuration.
The order was received but payment was not successfully processed - check the PayLexer Orders log.

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 PayLexer and WooCommerce dashboards during the initial testing period.

Final Checklist

Before going live, confirm all of the following:

Payment gateway tested successfully in Test Mode
At least one payment method enabled in WooCommerce
Website status shows Active in PayLexer
WooCommerce payment method set to PayLexer
Live credentials added (not just test)
Test Mode disabled in WooCommerce

FAQs

Yes. A PayLexer account is required to generate the Client ID and Site Key needed to connect your WordPress site.

Enable Test Mode in WooCommerce payment gateway settings and use Test credentials in PayLexer. Orders are created normally but processed as test transactions.

Yes, if the payment gateway supports refunds. Process refunds directly from the WooCommerce order page - they will sync with PayLexer and the payment gateway automatically.

Common causes include an incorrect Client ID or Site Key, the PayLexer plugin not being activated, or selecting the wrong website in your PayLexer account.

No, but enabling webhooks is recommended for faster updates, better reliability, and real-time syncing of payment events.

Go to PayLexer Dashboard → Websites, then click on your website to view your credentials again.

Still Have Questions?

PayLexer Support

Open a support ticket with the PayLexer team.

WooCommerce Support

Visit the official WooCommerce support resources.

For settings and advanced configuration, see the WooCommerce documentation.

Was this page helpful?

Last updated 1 day ago

Built with Documentation.AI