Description
PayXCommerce Gateway redirects customers from WooCommerce to PayXCommerce hosted checkout. It creates a payment request using your merchant API credentials, returns the customer to your store, and updates the order from signed payment webhooks. Classic and Blocks checkout are supported. Refunds can be requested from WooCommerce admin.
An active PayXCommerce merchant account and the WooCommerce plugin are required. The gateway supports separate Test and Live modes; credentials and webhook signing secrets must match the selected mode. The minimum WooCommerce version declared by the plugin is 7.0. The integration was exercised on WordPress 7.0 and 7.1, WooCommerce 11.2.1 and PHP 8.1; earlier supported versions are not claimed as tested.
This plugin uses the PayXCommerce external payment service at https://payxcommerce.com/. When a customer chooses the gateway, the store sends the order amount, currency, order reference, billing name, email, phone, address, city and country, plus return and webhook URLs to the PayXCommerce API. PayXCommerce processes the hosted payment and sends a signed result to the store. See https://payxcommerce.com/page/privacy-policy and https://payxcommerce.com/page/terms-of-service for service terms and privacy information. Configure your store privacy notice accordingly.
The bundled PayXCommerce PHP SDK is MIT-licensed; its license notice is included in LICENSE.txt. No merchant credentials, webhook secrets or customer records are bundled in the plugin ZIP.
Support
For setup or payment-integration help, visit https://payxcommerce.com/contact. Never send API secrets, webhook signing secrets or full customer payment details in a support request.
Installation
- Back up your store and payment settings. Upload the ZIP through Plugins > Add New Plugin > Upload Plugin, then activate PayXCommerce Gateway.
- Open WooCommerce > Settings > Payments > PayXCommerce. Select Test and enter your Test-mode HMAC API key/secret or Developer App credentials. Enter the matching webhook signing secret and save.
- Register the displayed webhook URL in the PayXCommerce merchant dashboard as a fallback. The plugin also sends its order-specific webhook URL with each payment request. Keep the webhook signing secret private; signed webhooks are required for trustworthy order updates.
- Complete a sandbox checkout and verify the WooCommerce order is updated after the signed callback. Switch to Live and enter Live credentials only when your store is ready to accept real payments.
The WordPress.org ZIP installs in wp-content/plugins/payxcommerce-gateway-for-woocommerce/. If an older copy lives in payxcommerce/ or payxcommerce-gateway/, install and activate the new ZIP; activation deactivates the old copy without deleting shared gateway settings. Confirm the new copy is active and the old copy is inactive before removing old files. Do not run both copies concurrently.
FAQ
-
Does the plugin support WooCommerce Blocks checkout?
-
Yes. Classic and Blocks checkout use the same gateway and saved payment settings.
-
Are Test payments isolated from Live?
-
Select Test or Live in gateway settings and use credentials issued for that mode. The API rejects a credential/mode mismatch.
-
What if a customer returns before the webhook arrives?
-
The signed webhook is authoritative for the order result. The plugin handles duplicate deliveries without duplicating the order transition.
-
Will changing the plugin directory erase my gateway settings?
-
No. The gateway uses the same WooCommerce option keys in both directory layouts. Back up the store before any plugin upgrade.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“PayXCommerce Gateway for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “PayXCommerce Gateway for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.3.14
- Show only the merchant-configured Checkout Description on classic checkout, including an intentionally blank description; keep Blocks checkout text merchant-controlled.
0.3.13
- Show actionable dependency guidance only on Plugins and PayXCommerce settings screens for authorized users.
- Check PHP compatibility before loading the SDK and reject incompatible activation before replacing an older copy.
0.3.12
- Align the WordPress.org directory slug and translation domain without changing gateway settings.
- Use WordPress HTTP and URL helpers in the bundled SDK for hosted checkout and credential checks.
- Keep the tested WordPress version in this readme only.
0.3.11
- Add a WordPress.org-format readme and tested compatibility headers.
- Standardize the install directory and protect upgrades from duplicate gateway activation.
0.3.10
- Preserve checkout return URLs across guest sessions.