About this plugin
Stop paying high fees and start accepting crypto like it’s 2026.
XPayr Crypto Gateway for WooCommerce is a non-custodial payment solution for modern merchants. Whether you sell digital goods, physical products, subscriptions, or services globally, XPayr helps connect your WooCommerce store to blockchain-based payments through a secure hosted checkout flow.
Why Choose XPayr?
- Flat 0.5% Fee — No hidden costs or complex pricing tiers. Keep more of your revenue.
- Non-Custodial & Secure — XPayr does not expose private keys inside your WooCommerce store. Customers complete payment through secure hosted checkout infrastructure with transparent payment status handling.
- 7+ Networks & 30+ Tokens — Accept payments across supported blockchain networks such as Ethereum, BNB Chain, Polygon, Base, and more using popular assets like USDT, USDC, and ETH, depending on your merchant configuration.
- Modern Checkout Experience — Provide a hosted crypto checkout flow with EIP-compatible wallet support and a streamlined payment experience for customers.
Powerful Features for Smart Merchants
- Hosted Checkout — Redirect customers to a secure, high-conversion payment page ( /pay/ps_xxx ). No sensitive wallet data touches your server.
- Real-Time Sync — Orders are updated automatically through webhook callbacks and optional Thank You page API verification.
- Webhook Support — Receive real-time IPN callbacks from XPayr with HMAC-SHA256 signature verification.
- Multi-Network Support — Select from available blockchain networks and supported currencies directly in WooCommerce settings.
- WooCommerce Blocks Compatible — Works with both the classic checkout shortcode and the Gutenberg-based Checkout block.
- HPOS Compatible — Fully compatible with WooCommerce High-Performance Order Storage (custom order tables).
- On-Chain Transparency — Give customers and operators auditable payment tracking with blockchain-linked transaction visibility.
- Auto-Configuration — Optionally auto-register the WooCommerce callback URL on XPayr and sync the webhook secret.
- Configurable Order Status — Choose whether completed payments set orders to “Completed” or “Processing.”
External services
This plugin relies on external services provided by XPayr.
Service: XPayr API
Used for creating payment sessions, checking payment status, listing available networks/currencies, and syncing webhook callback settings.
Data sent to the service:
- Order amount and currency
- Selected blockchain network
- WooCommerce order reference and order ID metadata
- Customer billing email
- Return/cancel/callback URLs used to complete checkout and receive updates
- API authentication key configured by the merchant
When data is sent:
- When the customer places an order with XPayr payment method
- When Thank You page sync is enabled and the order status is checked
- When webhook auto-sync is enabled in gateway settings
- When the merchant opens gateway settings and network catalog is requested
Service links:
- Website: https://xpayr.com
- Terms of Service: https://xpayr.com/legal/terms-of-service
- Privacy Policy: https://xpayr.com/legal/privacy-policy
Service: XPayr webhook callbacks
Used for sending payment result updates from XPayr back to the WooCommerce store.
Data sent from the service to the store:
- Payment event type
- Session ID
- Invoice ID when available
- Payment status details
- Order reference metadata previously created for the checkout session
- HMAC signature header used for webhook verification
When data is sent:
- When XPayr sends a payment confirmation, failure, or expiration callback to the WooCommerce webhook URL configured in the plugin
Service links:
- Website: https://xpayr.com
- Terms of Service: https://xpayr.com/legal/terms-of-service
- Privacy Policy: https://xpayr.com/legal/privacy-policy
Upgrade Notices
0.2.0
Adds WooCommerce Blocks and HPOS compatibility. Recommended update for all users.