Shadow Software Crypto for WooCommerce
| 开发者 | shadowsoftware |
|---|---|
| 更新时间 | 2026年7月13日 01:56 |
| 捐献地址: | 去捐款 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Ether (ETH) — native ETH on Ethereum, Base, Arbitrum One, and OP Mainnet.
- USDC and USDT — the leading dollar stablecoins, as ERC-20 tokens on those same networks (whichever are deployed there).
- Bitcoin (BTC) — native BTC on the Bitcoin mainnet.
- Documentation: https://github.com/shadow-software/shadow-software-crypto-for-woocommerce#readme
- Source code and releases: https://github.com/shadow-software/shadow-software-crypto-for-woocommerce
- Report a bug or request a feature: https://github.com/shadow-software/shadow-software-crypto-for-woocommerce/issues
- The merchant enters their own receiving addresses (one EVM address for ETH/USDC/USDT, and a Bitcoin address for BTC) and picks which assets to accept.
- The customer places the order and, on the pay page, chooses which crypto to pay with. The order total is converted from your store currency to that crypto at the live market rate and locked in.
- The pay page shows the exact amount, your address, and a scannable QR code. The customer pays from their own wallet.
- The customer confirms by entering the wallet address they paid from (and, optionally, the transaction ID — which is fastest).
- A background job checks the blockchain and completes the order once the payment has enough confirmations. The customer's page updates automatically.
- Self-custodial. Funds go straight to your wallets. The plugin never holds money and never sees a private key.
- No fees, no middleman, no account. There is no gateway service to sign up for and nothing takes a cut.
- Free tools only. Confirmation uses free public RPC nodes (EVM) and free public block explorers (Bitcoin); the exchange rate uses a free public price API. You can point any network at your own endpoint if you prefer.
- On-chain verified. An order is completed only after the exact payment is found on-chain with the confirmations you require — never from the browser alone. Each payment is bound to the buyer's own wallet and to a unique amount, so one payment can never settle two orders.
- Multi-asset, multi-network. ETH, USDC, USDT across Ethereum, Base, Arbitrum One and OP Mainnet, plus native Bitcoin — each individually toggleable.
- Address safety. Your receiving address is checked (including its EIP-55 checksum) when you save it, so a typo can't silently send funds nowhere.
- HPOS compatible and works with both the classic checkout shortcode and the WooCommerce Checkout block.
- Translation-ready.
安装:
- Upload the
shadow-software-crypto-for-woocommercefolder to/wp-content/plugins/, or install the ZIP via Plugins → Add New → Upload. - Activate the plugin through the Plugins menu.
- Go to WooCommerce → Settings → Payments → Crypto (self-custodial).
- Enable it and paste your EVM receiving address (for ETH/USDC/USDT) and/or your Bitcoin address, then tick which assets and networks to accept.
- Optionally adjust the required confirmations, underpayment tolerance, and payment window.
- Save. "Pay with crypto" now appears at checkout.
屏幕截图:
常见问题:
Does the plugin ever hold my money or my keys?
No. Customers pay your address directly from their own wallet. The plugin only reads the blockchain to confirm the payment. No private keys are ever entered or stored.
Is there any fee or account to sign up for?
No. The plugin is free and open source, there is no gateway service, and nothing takes a cut of your sales.
Which assets and networks are supported?
Native ETH, plus USDC and USDT (as ERC-20 tokens), on Ethereum mainnet, Base, Arbitrum One, and OP Mainnet — and native Bitcoin. Each asset and network can be enabled or disabled independently, and each network can be pointed at your own RPC or explorer endpoint.
How is the amount calculated?
When the customer chooses which crypto to pay with, the order total in your store currency is converted to that asset at the live market rate (via the free CoinGecko price API) and locked for the customer. Each order is given a tiny, unique amount so that one on-chain payment can never settle two orders. You can allow a small underpayment tolerance to absorb rate drift and rounding.
What if the customer doesn't know their transaction ID?
They can simply enter the wallet address they paid from. The plugin looks for a matching payment to your address from that wallet. Pasting the transaction ID is faster, but it is optional.
How does the plugin know the payment is from this customer?
Every payment is bound to the wallet address the customer entered and to the order's unique amount, and (for Bitcoin) must be dated at or after the order was placed. This prevents a customer from claiming someone else's payment or reusing one payment for several orders.
When is an order marked paid?
Only after the matching payment is found on-chain and has reached the number of confirmations you configured for that network. The customer's browser never completes an order on its own.
What happens if no payment arrives?
If a matching payment is not confirmed within the payment window you set, the order is marked failed so you are not left guessing.
Does it need an API key?
No. It works out of the box with free public nodes and a free public price API. You may optionally supply your own RPC endpoints.
Is HPOS (High-Performance Order Storage) supported?
Yes, along with the WooCommerce Cart and Checkout blocks.
Where are the documentation and the source code?
Both are on GitHub. The project README documents the security model, the supported assets and networks, the external services the plugin contacts, and how to build and test it: https://github.com/shadow-software/shadow-software-crypto-for-woocommerce#readme Bug reports and feature requests are welcome at https://github.com/shadow-software/shadow-software-crypto-for-woocommerce/issues
更新日志:
- The plugin is now listed on WordPress.org, and its "Documentation" links (on the gateway settings screen and the Plugins list) point at the project README on GitHub, which is the plugin's full documentation.
- Fixed those links to use the repository's current address; they previously relied on a GitHub redirect.
- No functional changes — payment handling is untouched.
- Initial release: self-custodial crypto payments to the merchant's own wallets — native ETH plus USDC and USDT (ERC-20) on Ethereum, Base, Arbitrum One and OP Mainnet, and native Bitcoin. Live fiat pricing per asset, on-chain confirmation via free public RPC nodes and block explorers (by transaction id or by sending wallet), a unique per-order amount and mandatory sender binding so one payment can never settle two orders, chain-id verification, configurable confirmations/tolerance/window, EIP-55 and Bitcoin address checking, bundled offline QR codes, HPOS support, and WooCommerce Blocks support.