ICPay Skill

Instruction manual for working with the ICPay project: SDK, widget, payment links, accounts, webhooks, relay payments, X402 v2, refunds, split payments, email notifications, demo site, and integrations (WordPress, WooCommerce, Shopify).

Feature overview

• Relay payments — Per-chain recipient addresses (EVM, IC, Solana); funds forwarded to your specified addresses; optional relay fee in account settings.
• X402 v2 — HTTP 402 “Payment Required” flow for IC, EVM, and Solana; sign authorization, ICPay facilitator settles; card/onramp-friendly.
• Currency — Payment links have fiatCurrencyId; user/account profile can set default fiat for payment (USD, EUR, etc.).
• QR and mobile — WalletConnect QR for desktop; deep links for mobile browsers so users can pay with mobile phone wallet apps.
• Wallet adapters — EVM: MetaMask, Coinbase, Brave, Rabby, OKX, WalletConnect. Solana: Phantom, Backpack. IC: Plug, Internet Identity (II), Oisy, NFID. Configurable enable/disable per adapter.
• Split payments — Optional: multiple merchants share revenue via split rules (target account + percentage in basis points).
• Refunds — Refund completed payments; execute-refunds worker; webhook payment.refunded; email notification for refund completed.
• Email notifications — Payment completed and refund completed emails to account; configurable templates; process-notifications worker.
• Webhooks — Merchant endpoint receives payment/refund events; HMAC-SHA256 verification.
• demo.icpay.org — Live demo/playground for building and testing custom widgets (all components, configurable options).
• betterstripe.com — Sandbox environment: same features as icpay.org but on testnets (Solana devnet, Base Sepolia, Ark network testnet, and other testnets) for developers.
• Filter tokens/chains — Widget config: tokenShortcodes, chainShortcodes, chainTypes to show only specific tokens or chains.