Description
XPay for WooCommerce adds secure XPay payment methods to your store. Customers pay without leaving your checkout, while card details go directly to XPay and never pass through your WordPress server.
The plugin supports classic checkout, Cart and Checkout Blocks, HPOS, Arabic, test and live modes, and WooCommerce refunds.
Features
- Card, ValU, Fawry, and other methods enabled for your XPay account.
- One-click connection through XPay. No API key is pasted or shown.
- Automatic, signed webhook setup for reliable order updates.
- Secure payment fields on the WooCommerce checkout and order-pay pages.
- Separate test and live connections.
- Full and partial refunds where the payment method supports them.
- Arabic and English support.
- Redacted diagnostic logs in WooCommerce.
External services
This plugin connects to XPay’s services and cannot process payments without them.
- api.xpay.app: the store creates payment sessions and refunds here. It sends the order amount, currency, order number, and the customer’s name, email, and phone number. The connection flow also sends the store name, URL, and icon so the merchant can identify the store before approving access.
- checkout.xpay.app: XPay’s secure payment fields and script load from here in the customer’s browser. The customer enters payment details directly into these fields. The customer’s name, email, phone number, and payment information are sent to XPay to process the payment.
XPay’s Terms of Service and Privacy Policy apply.
Installation
- In WordPress, go to Plugins Add New and search for “XPay for WooCommerce”.
- Click Install Now, then Activate.
- Go to WooCommerce Settings Payments XPay.
- Click Connect with XPay.
- Sign in to XPay, choose your business, and approve the connection.
- Return to WooCommerce and choose which payment methods to show.
The first connection uses test mode. Place a test order before accepting real payments.
Going live
- Open the XPay connection dialog.
- Select Live and click Connect live account.
- Approve the connection on XPay.
- Turn off Test mode and save.
- Place a small real order and confirm that its WooCommerce status updates.
Test and live connections use separate keys and webhooks.
FAQ
-
Do I need HTTPS?
-
Yes. The connection, payment fields, and webhooks require HTTPS.
-
Where do I enter API keys?
-
Nowhere. Click Connect with XPay and approve access on XPay. The plugin saves the required credentials without displaying them.
-
How do I choose payment methods?
-
Enable them for the merchant account in XPay, then use the Payment Methods tab in the plugin to choose which available methods this store shows and their order.
-
How do I test payments?
-
Keep Test mode enabled and use the test payment details provided in your XPay dashboard. Test mode does not move real money.
-
How do I configure webhooks?
-
The plugin configures them automatically when you connect. If the webhook status becomes unhealthy, open the connection dialog and click Reconfigure webhook.
-
How do I troubleshoot a payment?
-
Turn on Diagnostic logging in the XPay settings, reproduce the issue, then open WooCommerce Status Logs and select the latest
xpayeglog. Secrets and personal data are redacted before the log is written. -
Can I issue refunds from WooCommerce?
-
Yes, when the payment method supports refunds. ValU refunds are not currently supported by XPay.
-
Does XPay work with WPFunnels?
-
Yes. If customers return to the cart after paying and you do not use a working WPFunnels Pro upsell step, turn on WPFunnels compatibility in the XPay settings.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“XPay for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “XPay 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
1.0.4
- The installation steps on the plugin page now describe installing XPay from the WordPress plugin directory.
- The webhook health indicator no longer reports a failure when two payment updates for the same order arrive at the same moment. XPay retries the second update and the order is unaffected.
1.0.3
- XPay no longer clashes with other plugins on your site that use similar names. If you installed an earlier version from GitHub, open WooCommerce > Settings > Payments > XPay and connect again after updating.
1.0.2
- Corrected the Terms of Service and Privacy Policy links shown on the plugin page. Arabic now arrives as a WordPress language pack instead of being bundled, so translations can update without a plugin update.
1.0.1
- Corrected a link in the plugin header.
1.0.0
- First release. Accept card, ValU and Fawry payments on your WooCommerce checkout. Connect your XPay account in one click with no API keys to copy, with webhooks set up for you, refunds from WooCommerce, test and live modes, payment method controls, HPOS support and Arabic.