WooCommerce powers a huge share of the world's online stores, and adding a crypto payment gateway to it is one of the most-searched integrations in crypto commerce. The good news: it's genuinely simple. A WooCommerce crypto payment plugin registers as a normal payment method — customers pick 'pay with crypto' at checkout exactly like they'd pick a card.
This guide walks through the full setup with the crypt.pe plugin — a single PHP file, no dependencies, 0% transaction fees, and settlement directly to your own wallet — plus what to check regardless of which gateway you choose.
how a woocommerce crypto plugin works
A crypto payment gateway plugin hooks into WooCommerce's standard payment-method API. At checkout, the customer selects the crypto option; the plugin creates a payment order for the cart total via the gateway's API and redirects to a hosted crypto checkout showing coins, exact amounts and QR codes.
When the on-chain payment is detected and confirmed, the gateway fires a signed webhook back to your store, and the plugin flips the WooCommerce order to processing/completed — the same lifecycle as a card payment, without the card fees or chargebacks.
custodial vs non-custodial plugins
The architectural question matters more than any feature list. Custodial gateways (BitPay, NOWPayments, CoinPayments and similar) receive the customer's crypto into their wallets, deduct 0.5-2%, then settle to you — meaning KYC onboarding, settlement delays, country restrictions and a third party that can freeze funds.
A non-custodial WooCommerce crypto payment gateway never touches the money: the customer's wallet pays your wallet on-chain, and the plugin's only job is to create orders, show checkout and verify payments. crypt.pe is built this way — which is also why it can charge 0% per transaction instead of a percentage.
step-by-step: crypt.pe on wordpress / woocommerce
- 1. Create a free crypt.pe account and add your wallet addresses (public addresses only).
- 2. In the dashboard's gateway tab, generate an API key (sk_live_*) and webhook secret (whsec_*).
- 3. Download the plugin — one PHP file — and drop it into wp-content/plugins/cryptpe/.
- 4. WP Admin → Plugins → activate 'CRYPT.PE Crypto Payments'.
- 5. WooCommerce → Settings → Payments → enable 'Pay with CRYPT.PE' and paste your keys.
- 6. Place a test order and pay it with $2 from your own wallet — watch the order flip to processing when the payment confirms.
Orders auto-confirm on payment.confirmed; underpaid or overpaid transfers put the order on-hold with the mismatch flagged in your dashboard, so nothing silently slips through.
which coins should your store accept?
Enable the coins your customers actually hold. USDT and USDC (stablecoins — the sale is worth the same dollar amount when it confirms), BTC and ETH cover the overwhelming majority of demand; SOL, TRX and BNB are cheap, fast additions for their large regional communities. crypt.pe supports 19 coins across 13 networks, and each coin appears at checkout only when you've added a wallet for its network.
fees: what a woocommerce store really saves
Network fees are paid by the customer to the blockchain (cents on Tron, Solana or Base), never deducted from your payout. And there are no card-network chargebacks: a confirmed on-chain payment is final.
| gateway | per-transaction | on $10,000/mo |
|---|---|---|
| cards via Stripe/PayPal | 2.9% + 30¢ | ~$300+ |
| custodial crypto gateways | 0.5-2% | $50-200 |
| crypt.pe plugin | 0% + flat plan | $0-29 flat |
troubleshooting checklist
- checkout option not showing → confirm the plugin is activated and the payment method is enabled in WooCommerce → Settings → Payments
- orders stuck pending → verify the webhook secret matches and your site is reachable over HTTPS (webhooks retry with backoff)
- signature verification failing → make sure your handler verifies against the raw request body, not re-serialized JSON
- coin missing at checkout → add a wallet address for that coin's network in your crypt.pe dashboard first
references
- [1]WooCommerce payment gateway API docs
- [2]WordPress plugin developer handbook
- [3]BIP-21 payment URI scheme
primary sources last verified — details may change; confirm on the source pages.
frequently asked
What is the best crypto payment gateway for WooCommerce?
For most stores, a non-custodial gateway: 0% per-transaction fees, settlement to your own wallet, no identity-check gatekeeping and no third party holding funds. crypt.pe's plugin is one PHP file and takes about fifteen minutes to set up.
How do I accept crypto payments on WordPress without WooCommerce?
Use payment links or the embeddable checkout button: create an invoice or product link in crypt.pe and place it on any WordPress page — no store plugin required.
Does the WooCommerce crypto plugin auto-confirm orders?
Yes. The plugin listens for the signed payment.confirmed webhook and flips the order automatically; underpaid or overpaid amounts put the order on-hold with the mismatch flagged.
Are there transaction fees for accepting crypto on WooCommerce?
With crypt.pe, 0% per transaction on every plan. The customer pays the blockchain's network fee (typically cents), and nothing is deducted from what lands in your wallet.
