{"id":286031,"date":"2026-03-16T11:23:48","date_gmt":"2026-03-16T11:23:48","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/xpayr-gateway-for-woocommerce\/"},"modified":"2026-03-16T15:40:42","modified_gmt":"2026-03-16T15:40:42","slug":"xpayr-crypto-gateway-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/en-ca.wordpress.org\/plugins\/xpayr-crypto-gateway-for-woocommerce\/","author":23459685,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.2.5","stable_tag":"0.2.5","tested":"6.9.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"XPayr Crypto Gateway for WooCommerce","header_author":"XPayr","header_description":"Accept crypto payments via XPayr payment sessions.","assets_banners_color":"dfe7ef","last_updated":"2026-03-16 15:40:42","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/xpayr.com\/plugins\/woocommerce","header_author_uri":"https:\/\/xpayr.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":352,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.2.4":{"tag":"0.2.4","author":"xpayr","date":"2026-03-16 11:24:07"},"0.2.5":{"tag":"0.2.5","author":"xpayr","date":"2026-03-16 15:40:42"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3483804,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3483804,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3483804,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3483804,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.2.4","0.2.5"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"XPayr gateway settings page in WooCommerce.","2":"Crypto payment option displayed at checkout.","3":"XPayr hosted payment page."}},"plugin_section":[],"plugin_tags":[12624,170672,12611,257879,257880],"plugin_category":[45],"plugin_contributors":[257864],"plugin_business_model":[],"class_list":["post-286031","plugin","type-plugin","status-publish","hentry","plugin_tags-bitcoin-payments","plugin_tags-crypto-payment-gateway","plugin_tags-cryptocurrency","plugin_tags-usdt-payments","plugin_tags-web3-checkout","plugin_category-ecommerce","plugin_contributors-xpayr","plugin_committers-xpayr"],"banners":{"banner":"https:\/\/ps.w.org\/xpayr-crypto-gateway-for-woocommerce\/assets\/banner-772x250.png?rev=3483804","banner_2x":"https:\/\/ps.w.org\/xpayr-crypto-gateway-for-woocommerce\/assets\/banner-1544x500.png?rev=3483804","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/xpayr-crypto-gateway-for-woocommerce\/assets\/icon-128x128.png?rev=3483804","icon_2x":"https:\/\/ps.w.org\/xpayr-crypto-gateway-for-woocommerce\/assets\/icon-256x256.png?rev=3483804","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Stop paying high fees and start accepting crypto like it's 2026.<\/p>\n\n<p>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.<\/p>\n\n<h4>Why Choose XPayr?<\/h4>\n\n<ul>\n<li><strong>Flat 0.5% Fee<\/strong> \u2014 No hidden costs or complex pricing tiers. Keep more of your revenue.<\/li>\n<li><strong>Non-Custodial &amp; Secure<\/strong> \u2014 XPayr does not expose private keys inside your WooCommerce store. Customers complete payment through secure hosted checkout infrastructure with transparent payment status handling.<\/li>\n<li><strong>7+ Networks &amp; 30+ Tokens<\/strong> \u2014 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.<\/li>\n<li><strong>Modern Checkout Experience<\/strong> \u2014 Provide a hosted crypto checkout flow with EIP-compatible wallet support and a streamlined payment experience for customers.<\/li>\n<\/ul>\n\n<h4>Powerful Features for Smart Merchants<\/h4>\n\n<ul>\n<li><strong>Hosted Checkout<\/strong> \u2014 Redirect customers to a secure, high-conversion payment page (<code>\/pay\/ps_xxx<\/code>). No sensitive wallet data touches your server.<\/li>\n<li><strong>Real-Time Sync<\/strong> \u2014 Orders are updated automatically through webhook callbacks and optional Thank You page API verification.<\/li>\n<li><strong>Webhook Support<\/strong> \u2014 Receive real-time IPN callbacks from XPayr with HMAC-SHA256 signature verification.<\/li>\n<li><strong>Multi-Network Support<\/strong> \u2014 Select from available blockchain networks and supported currencies directly in WooCommerce settings.<\/li>\n<li><strong>WooCommerce Blocks Compatible<\/strong> \u2014 Works with both the classic checkout shortcode and the Gutenberg-based Checkout block.<\/li>\n<li><strong>HPOS Compatible<\/strong> \u2014 Fully compatible with WooCommerce High-Performance Order Storage (custom order tables).<\/li>\n<li><strong>On-Chain Transparency<\/strong> \u2014 Give customers and operators auditable payment tracking with blockchain-linked transaction visibility.<\/li>\n<li><strong>Auto-Configuration<\/strong> \u2014 Optionally auto-register the WooCommerce callback URL on XPayr and sync the webhook secret.<\/li>\n<li><strong>Configurable Order Status<\/strong> \u2014 Choose whether completed payments set orders to \"Completed\" or \"Processing.\"<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>This plugin relies on external services provided by XPayr.<\/p>\n\n<h4>Service: XPayr API<\/h4>\n\n<p>Used for creating payment sessions, checking payment status, listing available networks\/currencies, and syncing webhook callback settings.<\/p>\n\n<p>Data sent to the service:<\/p>\n\n<ul>\n<li>Order amount and currency<\/li>\n<li>Selected blockchain network<\/li>\n<li>WooCommerce order reference and order ID metadata<\/li>\n<li>Customer billing email<\/li>\n<li>Return\/cancel\/callback URLs used to complete checkout and receive updates<\/li>\n<li>API authentication key configured by the merchant<\/li>\n<\/ul>\n\n<p>When data is sent:<\/p>\n\n<ul>\n<li>When the customer places an order with XPayr payment method<\/li>\n<li>When Thank You page sync is enabled and the order status is checked<\/li>\n<li>When webhook auto-sync is enabled in gateway settings<\/li>\n<li>When the merchant opens gateway settings and network catalog is requested<\/li>\n<\/ul>\n\n<p>Service links:<\/p>\n\n<ul>\n<li>Website: <a href=\"https:\/\/xpayr.com\">https:\/\/xpayr.com<\/a><\/li>\n<li>Terms of Service: <a href=\"https:\/\/xpayr.com\/legal\/terms-of-service\">https:\/\/xpayr.com\/legal\/terms-of-service<\/a><\/li>\n<li>Privacy Policy: <a href=\"https:\/\/xpayr.com\/legal\/privacy-policy\">https:\/\/xpayr.com\/legal\/privacy-policy<\/a><\/li>\n<\/ul>\n\n<h4>Service: XPayr webhook callbacks<\/h4>\n\n<p>Used for sending payment result updates from XPayr back to the WooCommerce store.<\/p>\n\n<p>Data sent from the service to the store:<\/p>\n\n<ul>\n<li>Payment event type<\/li>\n<li>Session ID<\/li>\n<li>Invoice ID when available<\/li>\n<li>Payment status details<\/li>\n<li>Order reference metadata previously created for the checkout session<\/li>\n<li>HMAC signature header used for webhook verification<\/li>\n<\/ul>\n\n<p>When data is sent:<\/p>\n\n<ul>\n<li>When XPayr sends a payment confirmation, failure, or expiration callback to the WooCommerce webhook URL configured in the plugin<\/li>\n<\/ul>\n\n<p>Service links:<\/p>\n\n<ul>\n<li>Website: <a href=\"https:\/\/xpayr.com\">https:\/\/xpayr.com<\/a><\/li>\n<li>Terms of Service: <a href=\"https:\/\/xpayr.com\/legal\/terms-of-service\">https:\/\/xpayr.com\/legal\/terms-of-service<\/a><\/li>\n<li>Privacy Policy: <a href=\"https:\/\/xpayr.com\/legal\/privacy-policy\">https:\/\/xpayr.com\/legal\/privacy-policy<\/a><\/li>\n<\/ul>\n\n<h3>Upgrade Notices<\/h3>\n\n<h4>0.2.0<\/h4>\n\n<p>Adds WooCommerce Blocks and HPOS compatibility. Recommended update for all users.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>xpayr-crypto-gateway-for-woocommerce<\/code> folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate the plugin in WordPress Admin &gt; Plugins.<\/li>\n<li>Go to WooCommerce &gt; Settings &gt; Payments &gt; XPayr.<\/li>\n<li>Enable the payment method and configure:\n\n<ul>\n<li><strong>API Base URL<\/strong> (default: <code>https:\/\/xpayr.com\/api\/v1<\/code>)<\/li>\n<li><strong>Secret API Key<\/strong> (<code>sk_test_...<\/code> or <code>sk_live_...<\/code>)<\/li>\n<li><strong>Network<\/strong> and <strong>Currency<\/strong> defaults<\/li>\n<\/ul><\/li>\n<li>Save changes. The gateway will appear at checkout.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"what%20cryptocurrencies%20are%20supported%3F\"><h3>What cryptocurrencies are supported?<\/h3><\/dt>\n<dd><p>XPayr supports multiple stablecoins (USDC, USDT) across various blockchain networks including BSC, Base, and Ethereum. The available options depend on your XPayr merchant account configuration.<\/p><\/dd>\n<dt id=\"do%20i%20need%20an%20xpayr%20account%3F\"><h3>Do I need an XPayr account?<\/h3><\/dt>\n<dd><p>Yes. You need to register at <a href=\"https:\/\/xpayr.com\">xpayr.com<\/a> and obtain a Secret API Key to use this plugin.<\/p><\/dd>\n<dt id=\"is%20this%20plugin%20free%3F\"><h3>Is this plugin free?<\/h3><\/dt>\n<dd><p>The plugin itself is free and open source (GPLv2). XPayr may charge transaction fees as part of their payment processing service. Please review the <a href=\"https:\/\/xpayr.com\/legal\/terms-of-service\">XPayr Terms of Service<\/a> for details.<\/p><\/dd>\n<dt id=\"how%20does%20webhook%20verification%20work%3F\"><h3>How does webhook verification work?<\/h3><\/dt>\n<dd><p>XPayr signs webhook payloads with HMAC-SHA256 using a shared secret. The plugin verifies this signature before processing any webhook event to prevent unauthorized status changes.<\/p><\/dd>\n<dt id=\"does%20this%20work%20with%20woocommerce%20blocks%20checkout%3F\"><h3>Does this work with WooCommerce Blocks checkout?<\/h3><\/dt>\n<dd><p>Yes. The plugin registers as a block-compatible payment method and works with both the classic shortcode checkout and the Gutenberg-based Checkout block.<\/p><\/dd>\n<dt id=\"is%20there%20a%20live%20demo%3F\"><h3>Is there a live demo?<\/h3><\/dt>\n<dd><p>Yes. A live WooCommerce demo is available here:<\/p>\n\n<p>https:\/\/mbo.lol\/wp\/wp-login.php<\/p>\n\n<p>A read-only demo account is displayed on the login screen. After login, you can review the XPayr gateway settings in WooCommerce &gt; Settings &gt; Payments &gt; XPayr.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20the%20customer%20closes%20the%20payment%20page%3F\"><h3>What happens if the customer closes the payment page?<\/h3><\/dt>\n<dd><p>The order will remain in \"Pending\" status. If the payment session expires on XPayr, a webhook callback will update the order to \"Cancelled.\" You can also enable Thank You page sync for additional verification.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.2.5<\/h4>\n\n<ul>\n<li>Updated the public WordPress.org description copy.<\/li>\n<li>Replaced plugin directory tags with the new targeted keyword set.<\/li>\n<\/ul>\n\n<h4>0.2.4<\/h4>\n\n<ul>\n<li>Replaced the legacy WooCommerce <code>wc-api<\/code> webhook endpoint with a WordPress REST API webhook endpoint for safer request handling.<\/li>\n<li>Removed custom admin plugin row meta links that triggered unnecessary external service review warnings.<\/li>\n<\/ul>\n\n<h4>0.2.3<\/h4>\n\n<ul>\n<li>Expanded <code>== External services ==<\/code> documentation to explicitly cover inbound webhook callbacks and admin-facing external documentation links.<\/li>\n<li>Removed hardcoded remote icon fallback from WooCommerce Blocks assets so the checkout block uses only the plugin-provided local icon URL.<\/li>\n<\/ul>\n\n<h4>0.2.2<\/h4>\n\n<ul>\n<li>Added explicit <code>== External services ==<\/code> documentation with data flow and policy links.<\/li>\n<li>Hardened webhook payload handling with JSON parse checks plus field-level sanitization\/validation.<\/li>\n<li>Added strict URL validation for plugin row meta external links derived from API Base URL.<\/li>\n<\/ul>\n\n<h4>0.2.1<\/h4>\n\n<ul>\n<li>Renamed plugin to \"XPayr Crypto Gateway for WooCommerce\" to comply with trademark guidelines.<\/li>\n<li>Added <code>Requires Plugins: woocommerce<\/code> declaration.<\/li>\n<li>Applied strict prefixing (<code>XPAYRCGFW_<\/code>) to all globals, classes, options, and constants.<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>Added WooCommerce Blocks (Gutenberg checkout) compatibility.<\/li>\n<li>Added HPOS (High-Performance Order Storage) compatibility declaration.<\/li>\n<li>Added automatic webhook registration and secret sync.<\/li>\n<li>Added configurable order completion status (Completed vs Processing).<\/li>\n<li>Added plugin action links (Configure) and row meta links (FAQ, API docs, Support).<\/li>\n<li>Improved network and currency catalog loading from XPayr API.<\/li>\n<li>Added fallback catalog for when API is unavailable.<\/li>\n<li>Enhanced error handling and debug logging.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<li>Create XPayr payment sessions from WooCommerce checkout.<\/li>\n<li>Redirect customer to hosted XPayr checkout page.<\/li>\n<li>Store session_id, invoice_id, and payment_url in order meta.<\/li>\n<li>Optional order status sync on Thank You page.<\/li>\n<li>Basic webhook (IPN) processing.<\/li>\n<\/ul>","raw_excerpt":"Accept crypto payments in WooCommerce with XPayr&#039;s non-custodial hosted checkout, flat 0.5% fees, and real-time payment sync.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/286031","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=286031"}],"author":[{"embeddable":true,"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/xpayr"}],"wp:attachment":[{"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=286031"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=286031"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=286031"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=286031"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=286031"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/en-ca.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=286031"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}