icpay

Why ICPay?
<ul>
<li>Instant settlement to your wallet with no intermediaries or withdrawal delays. Customers pay, you receive – that simple.</li>
<li>0.5% transaction fees. Free to use. Start earning crypto in minutes.</li>
<li>Multi-chain support including Base, X402, and Internet Computer means your customers can pay using their preferred network and token.</li>
</ul>
Key Features:
<ul>
<li>Seamless WooCommerce gateway integration (Checkout + Order Pay pages)</li>
<li>Support for 50+ cryptocurrencies and tokens</li>
<li>Optional X402 (Coinbase) payment support enabled</li>
<li>Real-time payment confirmations via webhooks</li>
<li>Developer-friendly with extensive documentation</li>
<li>Secure, non-custodial – funds go directly to your wallet</li>
<li>Compatible with HPOS (High-Performance Order Storage) and Cart/Checkout Blocks</li>
<li>Express Checkout button (optional) for Cart and Checkout</li>
</ul>
This plugin:
<ul>
<li>Adds an ICPay payment gateway for WooCommerce checkout</li>
<li>Renders a pay button at checkout / order-pay</li>
<li>Updates order status automatically when payment completes or fails (webhooks and verification)</li>
<li>Reuses the Publishable Key from the ICPay plugin (if installed) or set keys locally</li>
<li>Provides Settings for:
<ul>
<li>Filter allowed tokens (optional) using searchable multi-select by token shortcode</li>
<li>Metadata editor (key/value) merged into widget metadata (orderId is added automatically)</li>
</ul>
</li>
<li>Progress bar is always enabled for a smooth checkout experience</li>
</ul>
<h3>Source code and build</h3>
This plugin includes minified frontend bundles: 
– assets/js/icpay-embed.min.js (ICPay widget) 
– assets/js/wc/index.umd.js (optional WalletConnect adapter UMD for the widget)
Public source (maintained and human-readable): 
– Widget: https://github.com/icpay/icpay-widget (MIT) 
– SDK: https://github.com/icpay/icpay-sdk (MIT) 
– WalletConnect (optional adapter runtime): https://github.com/WalletConnect/walletconnect-monorepo
Exact mapping of distributed files to source: 
– assets/js/icpay-embed.min.js → Built from https://github.com/icpay/icpay-widget (package “@ic-pay/icpay-widget”). 
 – Primary sources live under /src in that repository. 
 – Build target is the IIFE embed bundle at /dist/index.embed.js, which is copied and renamed to icpay-embed.min.js for this plugin distribution. 
 – Example tagged release used: see icpay-widget releases matching this plugin version. Repository includes full TS sources and sourcemaps. 
– assets/js/wc/index.umd.js → Built from https://github.com/icpay/icpay-widget at /src/index.umd.js (WalletConnect adapter UMD) and copied to /dist/wc/index.umd.js by the build script.
Build instructions (reproducible): 
1) Clone https://github.com/icpay/icpay-widget 
2) Install dependencies (pnpm, yarn, or npm): 
 – pnpm install 
3) Build the library (produces ESM, IIFE embed, and UMD adapter): 
 – pnpm build:embed 
 – The script also copies the WalletConnect UMD adapter to dist/wc/index.umd.js 
4) Copy artifacts into this plugin: 
 – dist/index.embed.js → instant-crypto-payments-for-woocommerce/assets/js/icpay-embed.min.js 
 – dist/index.embed.js.map (optional, recommended) → instant-crypto-payments-for-woocommerce/assets/js/icpay-embed.min.js.map 
 – dist/wc/index.umd.js → instant-crypto-payments-for-woocommerce/assets/js/wc/index.umd.js
Notes: 
– The widget depends on “@ic-pay/icpay-sdk”, which is fully open source at https://github.com/icpay/icpay-sdk; the SDK sources are not vendored into this plugin but are bundled into the distributed widget file as part of the upstream open-source build. 
– If you prefer, you may vendor the unminified files from icpay-widget/dist instead; WordPress.org accepts either shipping unminified sources with the plugin or providing public, maintained source links (as above).
<h3>External services</h3>
This plugin connects to the ICPay service operated by ICPay, Ltd. to process payments. Details below list what is used, when, what data is sent, and links to each provider’s terms and privacy policies.
1) ICPay API (icpay.org, api.icpay.org) — operated by ICPay, Ltd. 
– What/why: Create and manage a payment and receive payment status updates. 
– When: When rendering the pay button (client-side widget load) and when receiving payment webhooks or running order payment verification. 
– Data sent: Order amount (in store currency; sent with optional fiat_currency when store is not USD), selected crypto asset, and order metadata (e.g., orderId). Webhook payloads contain payment status updates for the order. 
– Terms: https://icpay.org/terms 
– Privacy: https://icpay.org/privacy
<h3>Additional third-party services used by the widget (optional)</h3>
2) WalletConnect RPC (rpc.walletconnect.org) — provided by WalletConnect 
– What/why: Facilitate mobile wallet connections via WalletConnect. 
– When: Only if the WalletConnect adapter is enabled AND the shopper chooses WalletConnect. 
– Data sent: Wallet session metadata and JSON-RPC requests needed to complete a payment. 
– Terms: https://walletconnect.com/terms 
– Privacy: https://walletconnect.com/privacy
3) Wallet vendor websites and app deeplinks — shown only if the WalletConnect adapter is enabled and the shopper chooses a wallet. Navigation happens only on explicit user action; the plugin does not send data to these vendors automatically. 
– Phantom: https://phantom.app — Terms: https://phantom.app/terms — Privacy: https://phantom.app/privacy 
– Solflare: https://solflare.com — Terms: https://solflare.com/terms-of-use — Privacy: https://solflare.com/privacy-policy 
– Coinbase: https://go.cb-w.com (redirect), https://www.coinbase.com — Terms: https://www.coinbase.com/legal/user_agreement — Privacy: https://www.coinbase.com/legal/privacy 
– Binance: https://app.binance.com, https://www.binance.com — Terms: https://www.binance.com/en/terms — Privacy: https://www.binance.com/en/privacy
4) On-ramp provider (optional and disabled in this plugin build) 
– The bundled WalletConnect adapter contains an optional on-ramp link for “Meld” (domain: https://meldcrypto.com). In this plugin distribution, on-ramp is disabled by default; no requests are made to this provider. 
– When: Only if a developer explicitly enables on-ramp in the widget configuration and the shopper chooses to open it. 
– Data sent: None by default in this plugin. If enabled by a developer, the provider’s own site and terms will apply. 
– Vendor site: https://meldcrypto.com (please refer to the vendor site for terms and privacy)
<h3>Remote assets and CDN fallbacks</h3>
<ul>
<li>This plugin bundles all primary JS/CSS/images locally and does not offload required assets to remote CDNs.</li>
<li>The optional WalletConnect adapter may reference external vendor logos or pages provided by those vendors. We ship local icons where possible; any navigation to vendor sites occurs only when the shopper explicitly chooses that wallet. No plugin settings or secrets are transmitted by simply rendering the checkout page.</li>
</ul>

Instant Crypto Payments for WooCommerce

Accept crypto payments (ICP, Bitcoin, stablecoins) in WooCommerce via ICPay. Gateway for secure checkout and webhook order updates.

primersystems

Primer Pay lets you put any post or page behind a micropayment wall using the x402 protocol. Visitors with the Primer Pay browser extension pay seamlessly and see your content instantly. No user accounts, no subscriptions, no payment forms.
How it works:
<ol>
<li>You enter your wallet address in Settings > Primer Pay.</li>
<li>You check “Enable x402 Paywall” on any post and set a price (e.g., $0.01 USDC).</li>
<li>Visitors with the Primer Pay Chrome extension pay automatically and see your content.</li>
<li>Visitors without the extension see a teaser and a prompt to install Primer Pay.</li>
<li>Payments settle on Base (Ethereum L2) via USDC — low fees, instant finality.</li>
</ol>
Features:
<ul>
<li>Gutenberg Content Gate block — visual divider between free teaser and paid content with inline settings</li>
<li>Classic editor support — <code>[primer_pay_x402]</code> shortcode plus sidebar meta box</li>
<li>Per-post price override (defaults to your site-wide price)</li>
<li>Per-post wallet override — route payments to a different wallet per post (multi-author support)</li>
<li>Multi-network: accept payments on Base, SKALE Base, or both — with configurable priority</li>
<li>Theme-matching paywall banner — inherits your site’s fonts, colors, and border radius</li>
<li>Configurable access duration: 30 minutes to “never expires”</li>
<li><code>.well-known/x402</code> discovery endpoint — JSON index for AI agents and crawlers to find purchasable content</li>
<li>Works with any theme that renders the_content() normally</li>
<li>No user accounts or login required</li>
<li>Non-custodial — payments go directly to your wallet</li>
</ul>
Requirements:
<ul>
<li>A wallet address on Base or SKALE Base (e.g., from MetaMask, Coinbase Wallet, or Primer Pay itself — same address works on all supported networks)</li>
<li>HTTPS recommended (cookies are marked Secure on HTTPS; HTTP still works for local dev)</li>
</ul>
<h3>External services</h3>
This plugin relies on the Primer x402 facilitator service to verify and settle payments. When a visitor attempts to pay for content, the plugin sends the signed payment authorization to the facilitator, which validates the signature and executes the on-chain USDC transfer on the Base network.
<ul>
<li>Service: Primer x402 Facilitator</li>
<li>Endpoint: https://x402.primer.systems/settle</li>
<li>When: Whenever a visitor submits a valid X-PAYMENT header to the plugin’s unlock endpoint</li>
<li>Data sent: The base64-encoded signed payment authorization (EIP-712 typed data) from the visitor, plus the payment requirements (amount, asset address, recipient wallet address, network). No personally identifiable information about the visitor is sent — the only identifier is the wallet address they signed with.</li>
<li>Terms of service: https://primer.systems</li>
<li>Privacy policy: https://primer.systems</li>
</ul>
This is the standard x402 protocol flow. If you prefer to run your own facilitator, you can configure a custom facilitator URL in the plugin settings.

Primer Pay

Monetize your WordPress content with x402 micropayments. No accounts, no subscriptions — just instant pay-per-view with USDC.

Instant Crypto Payments for WooCommerce vs Primer Pay