Tag: crypto gateway

Crypto wallet payment for WooCommerce plugin — v1.1.0

Crypto wallet payment for WooCommerce stores — done the right way: payments go directly from your customer’s wallet to yours — on Bitcoin, Ethereum, Cardano, Solana, XRP, BNB, Polygon, Arbitrum, Optimism, Sui, NEAR, USDT, and USDC. No payment processor, no revenue share, no middleman. Every order is verified on-chain automatically.

🔒 Direct-to-wallet, no custody  ·  ⚡ Auto on-chain verification  ·  📦 HPOS & Block Checkout ready

---

Most crypto payment plugins route your sales through a third-party processor — taking a cut of every transaction and adding a compliance layer you don’t need. This crypto wallet payment plugin for WooCommerce works differently: funds go directly from your customer’s wallet to the wallet address you configure, on-chain verification happens automatically, and you keep 100% of what you earn.

Built for WooCommerce stores that want to accept crypto without sacrificing the order management experience. Full admin tools, customer self-service, refund tracking, Test Mode, and compatibility with both Classic and Block checkout — all in one crypto wallet payment for WooCommerce plugin. Already running our card and ACH gateway? Pair it with the accept.blue Payment Gateway v2 for WooCommerce to give customers crypto, card, and bank-transfer options at the same checkout.

Crypto Wallet Payment for WooCommerce vs. Third-Party Processors

Choosing a direct crypto wallet payment for WooCommerce setup over a hosted processor means lower costs, faster settlement, and full custody of your funds:

	Third-Party Processor	✅ This Plugin
Transaction fees	1–2% per sale	None
Revenue share	Required	None
Where funds land	Processor → your bank	Direct to your wallet
On-chain verification	Handled by processor	Built in, automatic
Supported networks	Varies (usually 1–3)	11 blockchains, 13 assets
Data shared with third party	Yes	None

---

Core Features of the Crypto Wallet Payment for WooCommerce Plugin

Everything required to run a production crypto wallet payment for WooCommerce checkout — from live exchange rates to on-chain verification to partial refunds.

🔗 WalletConnect v2 + EIP-6963 Wallet Picker

EVM customers connect MetaMask, Phantom, Coinbase Wallet, Rainbow, or any installed browser extension through a single wallet picker powered by WalletConnect v2 and the EIP-6963 multi-wallet standard. Works on desktop and mobile — no manual address copying required.

✅ Automatic On-Chain Payment Verification

Once a customer submits their transaction ID, the plugin polls the appropriate blockchain API every 5 minutes via WP-Cron to confirm the payment on-chain. When confirmed, the order status updates automatically — no manual checking, no support tickets about “did my payment go through?”

⚡ Instant Webhook Confirmations

For stores that need faster confirmation, enable the built-in webhook endpoint and point Blockfrost (Cardano), Helius (Solana), or any supported provider at it. Payments are verified the moment a transaction finalizes on-chain — no polling delay, no cron dependency.

📱 Mobile Deep Links for BTC and XRP

Bitcoin and XRP customers on mobile see an Open in Wallet App button that fires the bitcoin: or xrpl: URI scheme with the wallet address and exact amount pre-filled. No copying, no typos.

💱 Live Exchange Rates with Rate Lock Timer

Exchange rates are fetched from CoinGecko every 5 minutes with admin-configurable fallback rates. Stablecoins (USDT/USDC) are always 1:1 with USD, with correct cross-rate conversion for non-USD stores. A countdown timer shows customers how long their quoted crypto amount is valid, and auto-refreshes on expiry.

🔄 Partial Refunds with On-Chain Tracking

Issue multiple partial refunds against the same order with running total tracking. Record the on-chain transaction hash after sending a manual refund, with a direct block explorer link stored in the order for your records and your customer’s.

🛡 Amount Tolerance Controls

Configurable underpayment tolerance (%) and overpayment warning threshold prevent false verification failures caused by exchange rate drift between the time an order is placed and the time payment arrives.

📦 HPOS + Block Checkout Compatible

Fully compatible with WooCommerce High Performance Order Storage (HPOS) and both Classic and Block (Gutenberg) checkout. Declared compatibility means no warnings in your WooCommerce status screen.

---

How Crypto Wallet Payment for WooCommerce Works: Checkout to Confirmed

The plugin manages the entire crypto payment lifecycle. Here’s what happens when a customer checks out:

1. Customer selects their coin and network — The live exchange rate and rate-lock countdown are shown immediately at checkout.
2. Payment is sent — Browser wallet auto-sends the exact amount (EVM, Cardano, Solana), or a QR code and copy-to-clipboard button handles manual transfer (BTC, XRP, SUI, NEAR, TRC-20).
3. On-chain verification runs automatically — WP-Cron or your webhook endpoint confirms the transaction hash against the blockchain API for the customer’s network.
4. Order is marked paid — Order status updates, stock decrements, and the confirmation email goes out. No manual intervention required.

---

Crypto Wallet Payment for WooCommerce: 11 Blockchains, 13 Supported Assets

Every network below is independently configurable — enable only what your store needs, enter your wallet address, and optionally add an API key for auto-verification.

Network	Asset	Wallet Method	Auto-Verify	API Key Required
Bitcoin	BTC	📱 Mobile deep link + QR	✅ Yes	None (Blockstream free API)
Ethereum	ETH	🔗 WalletConnect v2 / EIP-6963	✅ Yes	Etherscan
Cardano	ADA	💳 Vespr, Eternl, Lace	✅ Yes	Blockfrost
Solana	SOL	👻 Phantom, Solflare	✅ Yes	Helius
XRP Ledger	XRP	📱 Mobile deep link + QR	✅ Yes	None (XRPL public cluster)
BNB Smart Chain	BNB	🔗 WalletConnect v2 / EIP-6963	✅ Yes	BscScan
Polygon	POL	🔗 WalletConnect v2 / EIP-6963	✅ Yes	Polygonscan
Arbitrum	ETH	🔗 WalletConnect v2 / EIP-6963	✅ Yes	Arbiscan
Optimism	ETH	🔗 WalletConnect v2 / EIP-6963	✅ Yes	Optimism Etherscan
Sui Network	SUI	📋 Manual + QR	✅ Yes	None (Sui public full node)
NEAR Protocol	NEAR	📋 Manual + QR	✅ Yes	None (NEAR public RPC)

Stablecoin Support

USDT and USDC are supported across 7 networks each: ERC-20 (Ethereum), Solana SPL, TRC-20 (Tron), BEP-20 (BNB Chain), Polygon, Arbitrum, and Optimism. Stablecoins are always priced at 1:1 with USD — no exchange rate configuration needed. Wallet connect works for ERC-20, Polygon, Arbitrum, and Optimism variants; Phantom/Solflare handle SPL; TRC-20 and BEP-20 use QR/manual transfer.

---

Payment Verification: WP-Cron or Webhooks

The plugin offers two independent verification methods for confirming a crypto wallet payment for WooCommerce order — use one or configure both.

⏰ WP-Cron Polling (Default)

Out of the box, the plugin schedules a WP-Cron job that checks all on-hold orders with a transaction ID every 5 minutes. No configuration required — it works on any host. For low-traffic sites where WP-Cron may fire inconsistently, replace it with a real server cron job:

*/5 * * * * cd /path/to/wordpress && wp cron event run --due-now --quiet

⚡ Webhook Push (Instant)

Enable the webhook under WooCommerce → Settings → Payments → Crypto Wallet Payment → Verification. Copy the auto-generated secret token and point your blockchain provider at the endpoint below. When a transaction confirms, the provider pushes to your store immediately — no cron delay, no missed orders on low-traffic sites.

https://yourstore.com/ryanplugins-cww-webhook/?secret=YOUR_TOKEN

Enabling the webhook automatically disables WP-Cron polling. Disabling it re-enables polling. You cannot run both simultaneously.

---

Admin Tools and Order Management

The plugin adds crypto wallet payment for WooCommerce tooling throughout the admin — no separate dashboard to learn.

For Store Admins

• Dashboard widget — pending orders count, 7-day verified revenue, and missing TX ID alerts at a glance
• Orders screen columns — TX ID and Network shown inline without opening each order
• One-click verify — manually trigger on-chain verification from the order meta box
• Bulk verify — select multiple orders and verify all at once
• Refund TX hash — record the on-chain hash after sending a manual crypto refund, with a direct block explorer link
• Sensitive field masking — show/hide eye icon on API keys, webhook secret, and WalletConnect Project ID

For Customers

• Self-service TX ID submission — customers submit or update their transaction hash from My Account → Orders without contacting support
• Refund wallet address — collected at checkout, updatable from My Account at any time
• Live payment status widget — Thank You page polls for confirmation without a page refresh
• Order expiry — unpaid orders are automatically cancelled and stock restored after a configurable window
• Email instructions — wallet address and TX ID included in every order confirmation email

---

Requirements

Here’s what you need to run crypto wallet payment for WooCommerce on your store:

• WordPress: 5.8 or higher
• WooCommerce: 6.0 or higher
• PHP: 7.4 or higher (PHP 8.1+ recommended for bcmul support)
• PHP Extension: bcmath — required for ETH wei and SUI MIST precision conversions
• Checkout: Classic Checkout and Block Checkout both fully supported
• Order Storage: Compatible with WooCommerce HPOS (High Performance Order Storage)

---

Installation

Get crypto wallet payment for WooCommerce running in a few steps:

1. Upload the plugin folder to /wp-content/plugins/
2. Activate via Plugins → Installed Plugins
3. Go to WooCommerce → Settings → Payments → Crypto Wallet Payment
4. Add your wallet addresses under the Networks and Stablecoins tabs
5. Add API keys under the API Keys tab for any network you want auto-verified
6. Enable Auto-Verification under the Verification tab
7. Optionally configure Webhook, Order Expiry, Rate Lock Timer, and Amount Tolerance settings

Need a walkthrough? Setup guides are included with your license — just reach out to support@ryanplugins.net, or browse all RyanPlugins WooCommerce plugins to see what pairs well with this one.

---

Changelog

v1.1.0 — April 8, 2026

Three new L2 networks, seven new stablecoin variants, and ten bug fixes.

New Networks & Assets

• New: Polygon (POL) — WalletConnect v2 / EIP-6963, auto-verified via Polygonscan
• New: Arbitrum (ETH) — WalletConnect v2 / EIP-6963, auto-verified via Arbiscan
• New: Optimism (ETH) — WalletConnect v2 / EIP-6963, auto-verified via Optimism Etherscan
• New: USDT & USDC on Polygon, Arbitrum, and Optimism — wallet connect + auto-verify via respective block explorer APIs

Bug Fixes

• Fix: Polygon exchange rate showing “No exchange rate configured” — CoinGecko rebranded matic-network to polygon-ecosystem-token; now requests both IDs
• Fix: All Polygon, Arbitrum, and Optimism transactions incorrectly rejected by TX hash format check
• Fix: Amount verification silently skipped for Polygon, Arbitrum, Optimism, and all six L2 stablecoins
• Fix: L2 stablecoin amount check always used wrong lookup key — verify_etherscan_erc20_token() stripped the network prefix
• Fix: Any logged-in user could submit TX IDs for guest orders — ownership check logic was inverted
• Fix: Arbitrum testnet pointed at deprecated Goerli endpoint — updated to api-sepolia.arbiscan.io
• Fix: Dashboard widget “Refresh” AJAX always failed with a nonce error — ryanplugins_cww_dashboard_nonce was never passed to JavaScript
• Fix: Dashboard 7-day revenue window calculated incorrectly on non-UTC servers — replaced date() with wp_date()
• Fix: Text domain mismatch — all 300 __() calls used the wrong text domain, making every translatable string invisible to translation tools
• Fix: Coin icons for Polygon, Arbitrum, and Optimism not displaying at checkout or in admin — missing CSS icon classes added to checkout.css and admin.css

v1.0.0 — Initial Release

• New: Multi-network support — BTC, ETH, ADA, SOL, XRP, BNB, SUI, NEAR + USDT/USDC on ERC-20, SPL, TRC-20, BEP-20
• New: Browser wallet auto-send — Vespr, Eternl, Lace (Cardano), Phantom, Solflare (Solana), MetaMask / WalletConnect v2 / EIP-6963 (EVM)
• New: BTC & XRP mobile deep links
• New: Live exchange rates via CoinGecko with admin fallback rates and rate lock timer
• New: Auto-verification via WP-Cron and webhook endpoint
• New: Admin dashboard widget, order columns, one-click verify, bulk verify
• New: Partial refund support with TX hash tracking
• New: Customer self-service TX ID submission and refund wallet management via My Account
• New: Order expiry, live payment status widget, configurable amount tolerance
• New: Classic Checkout and Block Checkout support, WooCommerce HPOS compatibility, Test Mode

---

Crypto Wallet Payment for WooCommerce — Frequently Asked Questions

Does this plugin take a percentage of sales?

No. This crypto wallet payment for WooCommerce plugin charges no transaction fees, no revenue share, and involves no third-party processor. You pay once for the license and keep 100% of every payment. Funds go directly from your customer’s wallet to the wallet address you configure.

Do I need an API key for every network?

No. Bitcoin, XRP, Sui, and NEAR verify against free public APIs with no key required. Ethereum, Cardano, Solana, BNB Smart Chain, Polygon, Arbitrum, and Optimism require a free API key from their respective block explorer (Etherscan, Blockfrost, Helius, BscScan, Polygonscan, Arbiscan, or Optimism Etherscan). All free tiers are sufficient for typical store volumes.

What happens if a customer underpays due to exchange rate drift?

The plugin includes a configurable underpayment tolerance (%). Orders that fall within the tolerance are verified as paid. Orders below the threshold remain on-hold and trigger an alert. The rate lock timer reduces the window in which drift can occur by showing customers a countdown on their quoted amount.

Does it work with WooCommerce Subscriptions?

This crypto wallet payment for WooCommerce plugin is a standard payment gateway focused on one-time payments and manual renewal workflows. It does not currently support automated subscription renewals via WooCommerce Subscriptions.

Can I test before going live?

Yes. Test Mode uses separate testnet addresses, APIs, and block explorers for every supported network. Enable it under General settings, configure your testnet wallet addresses, and place test orders without touching real funds. Disable Test Mode before going live — orders placed in Test Mode are flagged and excluded from revenue reporting.

Is premium or priority support available?

Standard support is included with your license — email support@ryanplugins.net any time. If you want faster, prioritized responses (setup help, custom configuration questions, troubleshooting), join the RyanPlugins Premium Support membership.

---

Start Accepting Crypto Wallet Payment for WooCommerce Today

One license. 11 blockchains. 13 assets. Zero transaction fees. Payments land directly in your wallet — every time.

Built and supported by RyanPlugins  ·  License + updates delivered via Patreon  ·  Setup guides included

Questions? support@ryanplugins.net  ·  Early access & updates on Patreon  ·  Browse all WooCommerce plugins