IntegrationsWooCommerce
Integrations

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:

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

Register your site in PayLexer. Add your site →

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.

Test Mode

PayLexer supports full testing without real charges via WooCommerce's per-gateway Test Mode.

How Test Mode Works

  1. Go to WooCommerce → Settings → Payments.

  2. Click on the gateway you want to test (e.g., Stripe via PayLexer).

  3. Turn ON Test Mode.

  4. 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

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

Still Have Questions?

For settings and advanced configuration, see the WooCommerce documentation.