Descripcion
CryptoPayr for WooCommerce lets your store accept cryptocurrency at checkout, with two flows you choose in the settings:
- Hosted checkout (default) — the customer is sent to a hosted CryptoPayr checkout to pick a coin/network and pay.
- On-site checkout — the customer stays on your store: they pick a coin and network at checkout, then get a QR code, deposit address, the exact crypto amount and a live countdown right on the order-received page. The page auto-confirms as soon as the payment lands.
Either way the order is completed automatically by a signed webhook (HMAC-SHA256 with your store’s API key) — no manual reconciliation, and the browser is never trusted to declare payment.
One plugin covers every WooCommerce checkout:
- Accept Bitcoin, Ethereum, USDT, USDC and 110+ coins across major networks.
- Works with any fiat store currency — CryptoPayr prices the crypto for the buyer.
- Supports the classic (shortcode) checkout and the block-based Cart and Checkout.
- Hosted or on-site QR checkout — pick per store in the gateway settings.
- Declares High-Performance Order Storage (HPOS) compatibility.
- Orders are confirmed server-to-server by a signed webhook; the order only completes when the paid amount and currency match.
- No chargebacks — crypto payments are final once confirmed on-chain.
A free CryptoPayr merchant account and API key are required. See the External services section below for exactly what data is sent.
External services
This plugin connects to the CryptoPayr payment gateway API to create hosted crypto-checkout sessions and to receive payment confirmations. This connection is required for the plugin to process payments; without it the gateway cannot function.
Service provider: CryptoPayr — https://cryptopayr.com
What is sent and when:
- When a customer places an order and selects CryptoPayr, the plugin sends the order total, the order currency, the WooCommerce order id, and your store’s return, cancel and webhook URLs to https://cryptopayr.com/api/v1/payment/create to start a checkout session. Your CryptoPayr secret API key is sent in the request’s Authorization header to authenticate your store.
- In on-site mode the plugin also calls https://cryptopayr.com/api/v1/payment/methods (public, no key) to list the available coins/networks, and — after the customer picks one — https://cryptopayr.com/api/v1/payment/address (authenticated with your API key) to obtain the deposit address and amount to display. The buyer’s browser polls https://cryptopayr.com/api/v1/payment/lookup (public, no key) to detect confirmation.
- CryptoPayr then notifies your store of the payment result by posting a signed webhook back to your site’s WooCommerce API endpoint.
- This plugin does not transmit customer personal data (name, email, billing or shipping address). Only the amount, currency and order id are sent.
By using this plugin you agree to CryptoPayr’s terms and privacy policy:
- Terms of Service: https://cryptopayr.com/legal/terms
- Privacy Policy: https://cryptopayr.com/legal/privacy
Screenshots
Installacion
- Upload the plugin to
/wp-content/plugins/, or install the .zip via Plugins Add New Upload Plugin. - Activate the plugin through the Plugins menu in WordPress.
- Go to WooCommerce Settings Payments CryptoPayr.
- Enter your CryptoPayr API key (from your CryptoPayr dashboard Developers) and enable the method.
- Place a small test order to confirm the end-to-end flow.
FAQ
-
Do I need a CryptoPayr account?
-
Yes. Create a free merchant account at https://cryptopayr.com and copy your API key from Dashboard Developers.
-
Which checkout does it support?
-
Both. It works with the classic shortcode checkout and the block-based Cart and Checkout, and it declares HPOS compatibility.
-
What is on-site checkout?
-
An optional flow (set Checkout flow to « On-site » in the gateway settings) that keeps buyers on your store instead of redirecting them. The buyer picks a coin and network — at the classic checkout, or on the order-received page — and then sees a QR code, deposit address, the exact crypto amount and a countdown right there. The page confirms the payment automatically. On the block-based checkout the coin picker appears on the order-received page. Nothing about how the payment settles changes: it is still confirmed by the signed webhook.
-
Which cryptocurrencies can my customers use?
-
Bitcoin, Ethereum, USDT, USDC, BNB, Litecoin and 110+ more across multiple networks. Buyers choose their coin and network at the hosted checkout, or on your store in on-site mode.
-
How are orders confirmed?
-
CryptoPayr posts a signed webhook to your store when payment completes. The signature is verified with HMAC-SHA256 using your API key, and the order is only completed when the paid amount and currency match the order.
-
Are there chargebacks?
-
No. Crypto payments are final once confirmed on-chain, which removes card-style chargeback fraud.
-
How do refunds work?
-
Issue a refund from your CryptoPayr dashboard; the customer receives a link to choose a coin and return address for the payout.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“CryptoPayr for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
Translate “CryptoPayr for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- New on-site checkout flow: buyers pick a coin & network and pay via an embedded QR code, address, exact amount and countdown on the order-received page — no redirect off your store. The page auto-confirms when the payment lands, with a manual « Check for payment » fallback and underpayment guidance. Selectable per store via the new « Checkout flow » setting; the hosted checkout remains the default. Settlement is unchanged — still the signed webhook.
1.0.1
- Update the « Tested up to » WordPress version.
1.0.0
- Initial release. One plugin for the classic and block-based checkout, HPOS compatibility, and signed webhooks.