{"id":350526,"date":"2026-08-19T07:09:48","date_gmt":"2026-08-19T07:09:48","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/solopay-for-woocommerce\/"},"modified":"2026-08-19T08:20:40","modified_gmt":"2026-08-19T08:20:40","slug":"solopay-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/solopay-for-woocommerce\/","author":23544229,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0.4","requires":"6.5","requires_php":"8.1","requires_plugins":null,"header_name":"SoloPay for WooCommerce","header_author":"Solo Network","header_description":"Accept crypto payments via SoloPay. Gasless for users, instant settlement for merchants.","assets_banners_color":"131c1b","last_updated":"2026-08-19 08:20:40","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/guide.solonetwork.io\/en\/woocommerce\/","header_author_uri":"https:\/\/solonetwork.io","rating":0,"author_block_rating":0,"active_installs":0,"downloads":34,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"solonetwork","date":"2026-08-19 08:20:40"}},"upgrade_notice":{"1.0.0":"<p>Initial release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3654041,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3654041,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3654041,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3655562,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3655562,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3654016,"resolution":"1","location":"assets","locale":"","width":1825,"height":1028},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3654016,"resolution":"2","location":"assets","locale":"","width":1825,"height":832},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3654016,"resolution":"3","location":"assets","locale":"","width":1827,"height":801}},"screenshots":{"1":"SoloPay at WooCommerce checkout.","2":"Admin settings screen.","3":"Payment widget popup."}},"plugin_section":[],"plugin_tags":[21057,507,231844,209195,286],"plugin_category":[45],"plugin_contributors":[276427],"plugin_business_model":[],"class_list":["post-350526","plugin","type-plugin","status-publish","hentry","plugin_tags-crypto","plugin_tags-payment","plugin_tags-stablecoin","plugin_tags-usdc","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-solonetwork","plugin_committers-solonetwork"],"banners":{"banner":"https:\/\/ps.w.org\/solopay-for-woocommerce\/assets\/banner-772x250.png?rev=3655562","banner_2x":"https:\/\/ps.w.org\/solopay-for-woocommerce\/assets\/banner-1544x500.png?rev=3655562","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/solopay-for-woocommerce\/assets\/icon.svg?rev=3654041","icon":"https:\/\/ps.w.org\/solopay-for-woocommerce\/assets\/icon.svg?rev=3654041","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/solopay-for-woocommerce\/assets\/screenshot-1.png?rev=3654016","caption":"SoloPay at WooCommerce checkout."},{"src":"https:\/\/ps.w.org\/solopay-for-woocommerce\/assets\/screenshot-2.png?rev=3654016","caption":"Admin settings screen."},{"src":"https:\/\/ps.w.org\/solopay-for-woocommerce\/assets\/screenshot-3.png?rev=3654016","caption":"Payment widget popup."}],"raw_content":"<!--section=description-->\n<p>SoloPay is a Web3 payment gateway that lets WooCommerce merchants accept supported ERC-20 payments directly to their merchant-designated wallet, with USDC as the common default.<\/p>\n\n<p>This plugin is a client for the SoloPay payment service. A free SoloPay merchant account is required; the payment itself is processed by SoloPay, not by your WordPress site. See the \"External services\" section below for exactly what is sent where.<\/p>\n\n<p><strong>Key benefits<\/strong><\/p>\n\n<ul>\n<li><strong>Sponsored gas<\/strong> - for supported tokens, networks, and checkout flows, SoloPay covers the network gas fee so customers do not need a native gas token.<\/li>\n<li><strong>Direct settlement<\/strong> - confirmed payments are sent directly to your merchant-designated wallet, without a separate payout queue.<\/li>\n<li><strong>Non-custodial<\/strong> - funds go directly to your merchant wallet. SoloPay never holds your money.<\/li>\n<li><strong>No additional provider review<\/strong> - SoloPay does not add a separate payment-provider review or payout-approval step for supported checkout flows. Verification required by a wallet, exchange, merchant policy, industry rule, or applicable law may still apply.<\/li>\n<\/ul>\n\n<p><strong>Who it's for<\/strong><\/p>\n\n<p>SoloPay is built for WooCommerce merchants who sell to Web3-native customers and want to accept stablecoin payments without the complexity of running blockchain infrastructure themselves.<\/p>\n\n<p><strong>How it works (3 simple steps)<\/strong><\/p>\n\n<ol>\n<li>The customer chooses SoloPay at checkout and places the order.<\/li>\n<li>They are taken to a secure payment page that loads the SoloPay widget (popup on desktop, redirect on mobile) and pay with the supported ERC-20 token configured for your store, commonly USDC.<\/li>\n<li>SoloPay confirms the payment on-chain and notifies your store via a signed webhook, which marks the order complete and emails the customer.<\/li>\n<\/ol>\n\n<p>Learn more at <a href=\"https:\/\/solonetwork.io\">solonetwork.io<\/a>.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to the SoloPay payment gateway, operated by Solo Network. The connection is required: without it no payment can be created or confirmed, and the plugin has no useful function. By configuring the plugin with your SoloPay merchant credentials you consent to this data exchange.<\/p>\n\n<p><strong>1. SoloPay payment widget - https:\/\/widget.solonetwork.io<\/strong><\/p>\n\n<ul>\n<li><strong>When:<\/strong> each time a customer reaches the SoloPay payment page after placing an order, and clicks \"Pay now\". The request is made by the customer's browser, not by your server.<\/li>\n<li><strong>What is sent:<\/strong> your SoloPay public key, a per-attempt order reference (for example <code>wc-42-20260804101500-1-a1b2c3d4<\/code>), the order total, the store currency, the ERC-20 token contract address you configured, and the success and cancel URLs of your store.<\/li>\n<li><strong>What is not sent:<\/strong> no customer name, email address, phone number, billing address, shipping address, or cart contents.<\/li>\n<\/ul>\n\n<p><strong>2. SoloPay merchant API - https:\/\/gateway.solonetwork.io<\/strong><\/p>\n\n<ul>\n<li><strong>When:<\/strong> after a payment, once when the customer returns to your store's order-received page, and once when SoloPay sends its webhook. The request is made server-to-server by your site.<\/li>\n<li><strong>What is sent:<\/strong> your SoloPay merchant API key and the order reference described above.<\/li>\n<li><strong>What is received:<\/strong> the payment status, the paid amount, the token symbol, the on-chain transaction hash, and the confirmation timestamp. The transaction hash and timestamp are stored as order meta so you have a payment record.<\/li>\n<\/ul>\n\n<p><strong>3. Incoming webhooks<\/strong><\/p>\n\n<p>SoloPay sends signed HTTP POST requests to <code>\/wp-json\/solopay\/v1\/webhook<\/code> on your site. Every request is verified with an HMAC-SHA256 signature and rejected if the signature or timestamp does not check out. No outbound data is involved.<\/p>\n\n<p>Service documentation and legal terms:<\/p>\n\n<ul>\n<li>Terms of Service: <a href=\"https:\/\/solonetwork.io\/terms\">https:\/\/solonetwork.io\/terms<\/a><\/li>\n<li>Privacy Policy: <a href=\"https:\/\/solonetwork.io\/privacy\">https:\/\/solonetwork.io\/privacy<\/a><\/li>\n<li>Documentation: <a href=\"https:\/\/guide.solonetwork.io\">https:\/\/guide.solonetwork.io<\/a><\/li>\n<\/ul>\n\n<h3>Source code and build process<\/h3>\n\n<p>All JavaScript in this plugin is shipped in human-readable form. Nothing is minified or obfuscated.<\/p>\n\n<p>The file <code>assets\/js\/solopay-widget.js<\/code> is the SoloPay widget SDK loader. It is a Rollup bundle, and its complete TypeScript source together with the build configuration is included with this plugin under <code>src\/widget-js\/<\/code> (MIT licensed). Nothing in <code>src\/<\/code> is loaded or executed by WordPress; it is there so the shipped bundle can be verified and rebuilt.<\/p>\n\n<p>Merchants do not need to run a build: the distributed plugin already contains the ready-to-use JavaScript. The following steps are only for developers and WordPress.org reviewers who want to reproduce and verify the bundled SDK (requires Node.js 16 or later):<\/p>\n\n<ol>\n<li><code>cd src\/widget-js<\/code><\/li>\n<li><code>npm install<\/code><\/li>\n<li><code>npm run build<\/code><\/li>\n<li>Copy <code>dist\/widget.js<\/code> over <code>assets\/js\/solopay-widget.js<\/code><\/li>\n<\/ol>\n\n<p>Build tooling is Rollup 4 with <code>@rollup\/plugin-typescript<\/code> and <code>@rollup\/plugin-node-resolve<\/code>; see <code>src\/widget-js\/rollup.config.js<\/code>. Further notes are in <code>src\/README.md<\/code>.<\/p>\n\n<p>The files <code>assets\/js\/blocks.js<\/code> and <code>assets\/js\/payment-page.js<\/code> are hand-written plain JavaScript and need no build step.<\/p>\n\n<h3>Third-party assets<\/h3>\n\n<p>This plugin bundles the Quantico font (Regular, Italic, Bold, Bold Italic) by The Quantico Project Authors, licensed under the SIL Open Font License 1.1. The full license text is included at <code>assets\/fonts\/OFL.txt<\/code>. The font files are served from your own site; no external font CDN is contacted.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>In your WordPress admin, go to <strong>Plugins &gt; Add New Plugin<\/strong>, search for <strong>SoloPay for WooCommerce<\/strong>, and click <strong>Install Now<\/strong>. Alternatively, download the ZIP from <a href=\"https:\/\/wordpress.org\/plugins\/solopay-for-woocommerce\/\">WordPress.org<\/a> and install it using <strong>Upload Plugin<\/strong>.<\/li>\n<li>Click <strong>Activate<\/strong> on the SoloPay for WooCommerce plugin. WooCommerce must be installed and active.<\/li>\n<li>Go to <strong>WooCommerce &gt; Settings &gt; Payments<\/strong>, enable <strong>SoloPay<\/strong>, and click <strong>Manage<\/strong>.<\/li>\n<li>Enter your <strong>Public Key<\/strong>, <strong>Webhook Secret<\/strong>, <strong>Merchant API Key<\/strong>, and <strong>Token Address<\/strong> (the ERC-20 contract you accept, e.g. USDC). These are available in your SoloPay Merchant Dashboard at <a href=\"https:\/\/solonetwork.io\">solonetwork.io<\/a>. The Merchant API Key is required: the plugin uses it server-side to verify the paid amount before completing an order.<\/li>\n<li>Save changes. The plugin runs against the SoloPay production (mainnet) environment; there is no test-mode toggle (see the FAQ on testing).<\/li>\n<\/ol>\n\n<p><strong>Setting up the webhook<\/strong><\/p>\n\n<ol>\n<li>In WordPress, open <strong>WooCommerce &gt; Settings &gt; Payments &gt; SoloPay &gt; Manage<\/strong> and copy the <strong>Webhook URL<\/strong> displayed there. Depending on your permalink settings it looks like <code>https:\/\/yourstore.com\/wp-json\/solopay\/v1\/webhook<\/code> (pretty permalinks) or <code>https:\/\/yourstore.com\/?rest_route=\/solopay\/v1\/webhook<\/code> (plain permalinks).<\/li>\n<li>Open the SoloPay Merchant Dashboard, go to <strong>Settings &gt; Webhooks<\/strong>, and paste that URL.<\/li>\n<li>Copy the generated webhook secret into the plugin's <strong>Webhook Secret<\/strong> field and save.<\/li>\n<li>Copy the <strong>Merchant API Key<\/strong> (x-api-key) from the dashboard into the plugin's <strong>Merchant API Key<\/strong> field and save. The plugin uses this key to confirm the paid amount before completing an order. Completion happens when the buyer returns to the success page, and also via the webhook (which covers buyers who do not return). For the webhook to fire, its endpoint must be reachable from SoloPay (use a public URL or a tunnel during local testing).<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20solopay%20account%3F\"><h3>Do I need a SoloPay account?<\/h3><\/dt>\n<dd><p>Yes. The plugin is a client for the SoloPay payment service and cannot process payments on its own. Creating a merchant account at <a href=\"https:\/\/solonetwork.io\">solonetwork.io<\/a> is free.<\/p><\/dd>\n<dt id=\"what%20currencies%20are%20supported%3F\"><h3>What currencies are supported?<\/h3><\/dt>\n<dd><p>Your store keeps its normal WooCommerce currency. At checkout the order total is sent to SoloPay together with that currency, and the customer pays in the ERC-20 token you configure in the plugin (USDC is the common choice). SoloPay converts the fiat amount to the token using its real-time price.<\/p><\/dd>\n<dt id=\"do%20customers%20need%20a%20crypto%20wallet%3F\"><h3>Do customers need a crypto wallet?<\/h3><\/dt>\n<dd><p>Yes. Customers pay from a compatible Web3 wallet using the supported ERC-20 token configured for your store, commonly USDC. For supported payment flows, SoloPay sponsors the gas fee so customers do not need a separate native gas token.<\/p><\/dd>\n<dt id=\"are%20there%20transaction%20fees%3F\"><h3>Are there transaction fees?<\/h3><\/dt>\n<dd><p>There are no gas fees for your customers. Any service fees are defined by your SoloPay merchant agreement and shown in your dashboard.<\/p><\/dd>\n<dt id=\"which%20blockchain%20networks%20are%20supported%3F\"><h3>Which blockchain networks are supported?<\/h3><\/dt>\n<dd><p>This release uses the single ERC-20 token contract you configure in the plugin settings (USDC is the common choice). Network and contract management is handled in your SoloPay Merchant Dashboard.<\/p><\/dd>\n<dt id=\"what%20customer%20data%20is%20shared%20with%20solopay%3F\"><h3>What customer data is shared with SoloPay?<\/h3><\/dt>\n<dd><p>None of your customers' personal data. Only the order reference, the order total, the store currency, the token address, and your store's return URLs are sent. See the \"External services\" section for the full breakdown.<\/p><\/dd>\n<dt id=\"is%20there%20a%20test%20mode%3F\"><h3>Is there a test mode?<\/h3><\/dt>\n<dd><p>The plugin runs against the SoloPay production (mainnet) environment and there is no test-mode setting, because SoloPay selects the environment by endpoint rather than by key prefix (both environments issue pk_live_ keys). Developers who need to test against a testnet (such as Polygon Amoy) can point the plugin at the development endpoints by defining two constants in <code>wp-config.php<\/code>, without editing any plugin file:<\/p>\n\n<pre><code>define( 'SOLOPAY_WIDGET_URL', 'https:\/\/widget.dev.solonetwork.io' );\ndefine( 'SOLOPAY_API_BASE_URL', 'https:\/\/gateway.dev.solonetwork.io' );\n<\/code><\/pre><\/dd>\n<dt id=\"is%20it%20safe%3F\"><h3>Is it safe?<\/h3><\/dt>\n<dd><p>Yes. SoloPay is non-custodial, so funds settle directly to your wallet. Every webhook is signed with HMAC-SHA256 and verified by the plugin before any order is updated, with replay protection to prevent tampering. An order is only completed after the paid amount has been re-checked server-side against the order total.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20work%20with%20the%20block-based%20checkout%3F\"><h3>Does the plugin work with the block-based checkout?<\/h3><\/dt>\n<dd><p>Yes. SoloPay registers a Cart and Checkout Blocks payment method and declares compatibility with WooCommerce High-Performance Order Storage (HPOS).<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release.<\/li>\n<\/ul>","raw_excerpt":"Accept non-custodial USDC payments in WooCommerce with sponsored gas on supported flows, powered by SoloPay.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/350526","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=350526"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/solonetwork"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=350526"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=350526"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=350526"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=350526"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=350526"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=350526"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}