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.

Trelis

<h4>Non-custodial crypto payments made easy</h4>
Accept USDC directly to your wallet. Allow customers to pay by connecting any major Polygon wallet (Metamask, Coinbase Wallet, Rainbow Wallet, Ledger, Trezor).
<h4>What are the benefits for me (the store owner)?</h4>
<ul>
<li>Accept recurring payments Customers can subscribe for automatic monthly or annual payments.</li>
<li>Accept payments within mins. Install the plugin and add api keys from Trelis.com .</li>
</ul>
<h4>What are the benefits for my customers?</h4>
<ul>
<li>Pay with any major Polygon wallet. Metamask, Coinbase, Rainbow, Ledger, Trezor</li>
<li>Gasless payments. Customers pay in USDC, no gas required!</li>
</ul>
<h3>Getting Started</h3>
<ol>
<li>Install the Trelis Crypto Payments plugin</li>
<li>For MemberPress, navigate to MemberPress -> Settings -> Payments</li>
<li>For WooCommerce, navigate to WooCommerce -> Settings -> Payments -> TrelisPay -> Manage</li>
<li>Navigate to <a href="Trelis.com" rel="nofollow ugc">Trelis.com</a> and connect your wallet. This wallet will receive payments. It is highly recommended to use a cold wallet. You are solely responsible for custody of your funds. To offer gasless USDC payments, purchase gas credits from your dashboard.</li>
<li>Navigate to the api screen to create a new api key.</li>
<li>Copy the api webhook url from WordPress and enter it on Trelis.com</li>
<li>Copy the apiKey, apiSecret and webhook secret from Trelis.com and enter them into WordPress.</li>
<li>Press “Save changes” on WordPress to confirm changes. Your plugin is now configured to accept Ethereum payments.</li>
<li>If you already have products priced in US dollars, customers can now pay with USDC on Ethereum. Alternately you can update products or create new products that are priced in USDC or ETH.</li>
</ol>

Trelis Crypto Payments

Accept web3 recurring payments and gasless payments directly to your wallet. Your customers pay by connecting any major Polygon wallet.

Instant Crypto Payments for WooCommerce vs Trelis Crypto Payments