Instant Crypto Payments

Why icpay?

Instant settlement to your wallet with no intermediaries or withdrawal delays. Customers pay, you receive – that simple.
0.5% transaction fees. Free to use. Start earning crypto in minutes.
Multi-chain support including Base, x402, and Internet Computer means your customers can pay using their preferred network and token.

Perfect for:

• E-commerce stores wanting to tap into crypto-native customers
• Digital products and services
• SaaS businesses
• International payments without currency conversion fees

Key Features:

• Seamless WooCommerce integration
• Support for 50+ cryptocurrencies and tokens
• Real-time payment confirmations
• Developer-friendly with extensive documentation
• Secure, non-custodial – funds go directly to your wallet
• Optional X402 (Coinbase) payment support enabled

Built for developers, loved by merchants.
Get started in minutes at icpay.org

This plugin:

• Provides a Gutenberg block and shortcodes for all icpay payment widgets (Pay Button, Amount Input, Tip Jar, Premium Content, Article Paywall, Donation Thermometer, Coffee Shop)
• Enqueues the ICPay payments widget script locally
• Adds admin settings for publishable and secret keys
• Receives icpay payments webhooks to update local data
• Syncs payments from icpay payments (manual and cron)
• Stores payments in a local table with enriched data (amountUsd, amountUnits, ledgerSymbol (token), pluginSource, wp user)
• Shows an admin list with filters, pagination, and detail view
• Adds Tools action to clear local ICPay payment history (with confirmation)

Requires an icpay account and API keys.

Frontend widgets use the publishable key; server tasks use the secret key.

To obtain keys, create an account on https://icpay.org and generate them in your dashboard.

Source code and build

This plugin includes a minified frontend script for the widget: assets/js/icpay-embed.min.js.

Widget source (primary): https://github.com/icpay/icpay-widget
SDK source (dependency): https://github.com/icpay/icpay-sdk
Build notes (recommended): The minified icpay-embed.min.js is built from the open-source icpay-widget repository.

To reproduce:
1. Clone icpay-widget and install deps (pnpm/yarn/npm supported): pnpm install
2. Build: pnpm build
3. Copy the generated minified widget bundle to this plugin at assets/js/icpay-embed.min.js.

External service disclosure

This plugin connects to the ICPay service operated by icpay, Inc. to process payments:
– What: Payment creation and status updates.
– When: When rendering the widget (publishable key) and when receiving webhooks; when syncing payments from your dashboard.
– Data sent: Payment amounts, selected crypto asset, and optional metadata you configure (e.g., order ID). Webhook payloads contain payment status updates.
Privacy Policy: https://icpay.org/privacy
Terms of Service: https://icpay.org/terms

Additional third-party services used by the widget (optional)

• Identity (authentication): https://identity.ic0.app — opened only when a user chooses Internet Identity. No static assets are offloaded; it is an external login service.
• On-ramp provider: https://global.transak.com (or https://global-stg.transak.com in non-production) — used only when the on-ramp modal is triggered. No static assets are offloaded; it is a payment service.

No JS/CSS/images are loaded from remote CDNs by this plugin. All static assets (scripts, styles, and images) used by the plugin UI are bundled and served locally within the plugin. The build script enforces this by rejecting known disallowed remote asset references.

1. Upload the icpay-payments folder to the /wp-content/plugins/ directory, or upload the zip via Plugins → Add New → Upload.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. Go to Instant Crypto Payments → Settings and enter your Publishable and Secret keys.
4. (Optional) Configure global defaults.
5. Use the Instant Crypto Payments block in the editor to insert widgets, or shortcodes if preferred.
6. Add a webhook endpoint in your ICPay account pointing to /wp-json/icpay-payments/v1/webhook. This endpoint is public by design but securely verified using an HMAC-SHA256 signature header.

1.2.2

• Block editor: replaced “Accepted tokens” toggles with a searchable multi‑select “Filter allowed tokens (optional)” UI.
• Block editor: now shows chain name in brackets next to token symbol; selected tokens are sorted by chain then symbol.
• Block editor: “Amount (USD)” accepts arbitrary decimals (step=any), e.g. 0.0005 or 1.12.
• Block editor: label renamed “Component” → “Widget Type”; default button label uses “crypto”.
• Shortcodes/block render: removed deprecated “Disable button” and “Disable after success” flags.
• Settings: added Tools section with “Clear ICPay payment history” button (with confirmation) to truncate local synced icpay payment records.
• API/SDK integration: enriched public tokens response to include chain metadata used by the editor (chainName, chainShortcode, chainType, nativeSymbol, rpcChainId).
• Documentation: note optional support for X402 (Coinbase) payments where enabled.

1.0.25

• Compliance updates: source links in headers/readme, nonce checks, SQL prepare fix, progress bar defaulting, moved Sync button to Payments page, webhook namespace switched to icpay-payments.