/
WooCommerce Plugin User Guide

PayXpert - User documentation

WooCommerce Plugin User Guide

Latest Version: Version 1.3.1 includes [updates, bug fixes].

Introduction

Overview

This PayXpert payment plugin extends the functionality of WooCommerce, adding secured and easy integrated payment options. This plugin is designed to simplify and enhance your online store's capabilities, providing a seamless experience for you and your customers.

Key Features

  • [Card payments]: Accept card payments via PayXpert.

  • [Seamless or Redirection]: Choose between Seamless Checkout option and enriched Redirection.

  • [HPOS compatible]: The plugin is compatible with WooCommerce's High-Performance Order Storage (HPOS), ensuring faster and more efficient order management for high-traffic stores.

  • [Multi-Language Support]: Fully translated into English, French, and Spanish for a smooth user experience.


Getting Started

Prerequisites

Before configurating, ensure the following:

  • WooCommerce version: 7.6 or later

  • PHP version: 8.0 or later

  • WordPress version: 6.2 or later

  • Active SSL Certificate

Tip: The Plugin’s Status section will help you to identify information above.

Downloading the Plugin

Warning: these are the only two locations the PayXpert WooCommerce plugin is publsihed. Never download the plugin from other websites.


Installation

Automatic Installation

  1. Log in to your WordPress Admin Panel.

  2. Navigate to Plugins > Add New.

  3. Search for PayXpert WooCommerce.

  4. Click Install Now and then Activate.

Manual Installation

  1. Download the plugin .zip file from [PXP GIT LINK].

  2. Log in to your WordPress Admin Panel.

  3. Navigate to Plugins > Add New > Upload Plugin.

  4. Upload the .zip file, click Install Now, and activate.

Troubleshooting Tip: If the plugin fails to install, verify file permissions are set correctly in your hosting environment.


Settings

Here is a video guide on PayXpert-WooCommerce v1.3.0 plugin installation and configuration:

Plugin-WooCommerce-1080.mp4
Video guide on PayXpert-WooCommerce v1.3.0. plugin
installation and configuration

Accessing the Settings

  1. Go to WooCommerce > Settings > Payments.

  2. Click on the PayXpert Settings tab to access the plugin's configuration page.

payxpert_woocommerce_plugin_settings.png

To access the plugin configuration page, go to WooCommerce > Settings > Payments tab > PayXpert Settings

Authentication

Enter the following credentials:

  • Originator ID: This is provided by PayXpert and uniquely identifies your account.

  • Password: Use the password associated with your PayXpert account.

Note: Configuration sections such as Payment Methods, Transaction Operation, and Notifications will only become active after successful authentication.

Tip: Ensure that your credentials are accurate. If authentication fails, double-check your details or contact PayXpert support for assistance.

Payment Methods

Navigate to the Payment Methods section to enable and configure the payment options:

  • Enable WeChat Pay: Toggle to allow customers to pay via WeChat Pay.

  • Enable Alipay: Toggle to allow customers to pay via Alipay.

  • Enable Card Payment: Toggle to accept credit card payments.

Credit Card Mode

The Credit Card Mode setting allows you to choose how your customers will complete their payments. You can select between Redirection and Seamless Checkout, each offering distinct benefits depending on your business needs:

  1. Redirection Mode:
    In this mode, customers are redirected to a secure external PayXpert-hosted and accessible payment page to complete their transactions.

    • Offers a secure payment page optimized for user experience, accessible and inclusive for people with visual impairments.

    • Reduces the need for advanced server-side configurations on your WooCommerce site.

Best For: Businesses that prioritize ease of setup and security delegation.

 

  1. Seamless Checkout Mode:
    This mode embeds the payment form directly into your checkout page, allowing customers to complete their transactions without leaving your site.

    • Provides a more streamlined checkout experience, reducing friction and potential drop-offs.

    • Maintains your website’s branding throughout the entire transaction process.

Best For: Businesses with sufficient technical resources.

 

💡 Tip: If you're unsure which mode to choose, please start with Redirection Mode for its simplicity, advanced User Experience and enhanced security management

 

Configuration Settings

  • Transaction Operation: Choose the default operation for transactions (e.g., Sale).

  • Pay Button Title: Customize the text on the payment button (e.g., "Pay Now").

  • Seamless Checkout Version: Displays the seamless version in use.

  • Integrity Hash: A unique hash to ensure secure integration.

  • Payment Page URL: The URL for the payment page: https://connect2.payxpert.com. Do not change this field unless provided with a specific URL.

  • Payment Gateway URL (Refund): The URL for processing refunds: https://connect2.payxpert.com. Do not change this field unless provided with a specific URL.

Notifications

Manage merchant notifications to keep you informed after payment attempts.

  • Merchant Notifications: Enable, disable, or set per default account notifications.

  • Merchant Email Notifications Recipient: Enter the email address to receive notifications.

  • Merchant Email Notifications Language: Set the language for merchant notifications.

Logging Events

  • Enable logging to track PayXpert events, such as callback attempts, for troubleshooting and record-keeping.


FAQ

How do I resolve a "Plugin Not Found" error?

Answer: Ensure the plugin folder is uploaded correctly to the /wp-content/plugins/ directory and activate it from the WordPress Admin Panel.

Does this plugin support WooCommerce's High-Performance Order Storage (HPOS)?

Answer: Yes, our plugin is fully compatible with WooCommerce's HPOS, allowing for faster order processing and improved scalability for high-traffic stores. Simply enable HPOS in your WooCommerce settings, and our plugin will seamlessly integrate without any additional configuration required.

Does this plugin support WordPress blocks for the checkout page?

Answer: No, the plugin is not compatible with WordPress block-based checkout pages. However, we are actively working on adding compatibility in a future update. To use the plugin, please switch to the classic checkout page by adding the [woocommerce_checkout] shortcode.


Support

Contacting Support

For help, reach out to our support team at assistance@payxpert.com or open a ticket.

Documentation Links


Changelog

  • Version 1.3.1

    • readme.md updates

    • bug fixes

  • Version 1.3.0

    • Added support for Woo HPOS.

    • Plugin translated to French, Spanish

The upcoming update, expected in Q1 2025, will include the following improvements:

  • WP Block Editor Support: Full compatibility with the WordPress block editor.

  • Custom Redirect Pages: Ability to customize and set specific pages for handling redirects from the payment page.

  • Minor Improvements: Various enhancements to improve the overall user experience.

 

© PayXpert Services Ltd, 2025