Title: AvoPay Bitcoin for WooCommerce Author: avopaydev Published: 2. Juni 2026 Last modified: 24. Juli 2026 --- Plugins suchen ![](https://ps.w.org/avopay-bitcoin-for-woocommerce/assets/banner-772x250.png?rev =3558089) ![](https://ps.w.org/avopay-bitcoin-for-woocommerce/assets/icon-256x256.png?rev= 3558089) # AvoPay Bitcoin for WooCommerce Von [avopaydev](https://profiles.wordpress.org/avopaydev/) [Herunterladen](https://downloads.wordpress.org/plugin/avopay-bitcoin-for-woocommerce.1.0.26.zip) * [Details](https://de.wordpress.org/plugins/avopay-bitcoin-for-woocommerce/#description) * [Rezensionen](https://de.wordpress.org/plugins/avopay-bitcoin-for-woocommerce/#reviews) * [Installation](https://de.wordpress.org/plugins/avopay-bitcoin-for-woocommerce/#installation) * [Entwicklung](https://de.wordpress.org/plugins/avopay-bitcoin-for-woocommerce/#developers) [Support](https://wordpress.org/support/plugin/avopay-bitcoin-for-woocommerce/) ## Beschreibung AvoPay lets your WooCommerce store accept Bitcoin payments with zero chargebacks, no KYC, and no code changes required. Payments settle directly to your self-custodial AQUA wallet — no middleman, no custodian. AvoPay never holds your money. There is no AvoPay balance, no withdrawal step, and no custodial account — every payment settles wallet-to-wallet. Bitcoin appears as one more payment method at checkout, working alongside your existing gateways (Stripe, PayPal, cards) rather than replacing them. Learn more at [avopay.dev/woocommerce](https://avopay.dev/woocommerce?utm_source=wordpress&utm_medium=plugin&utm_campaign=woocommerce). #### Features * Zero node setup — no Bitcoin or Lightning node required * Non-custodial — funds go directly to your AQUA wallet * Two payment options — Lightning invoice or direct Liquid Bitcoin (L-BTC) payment * Automatic sats conversion — for stores priced in EUR, USD, GBP, CAD, AUD, JPY, CHF, DKK, or BRL * No chargebacks — Bitcoin payments are irreversible by design * Built-in retry flow — up to 3 automatic retries per order * Full audit log — every payment event stored per order #### How it works 1. Customer selects Bitcoin at checkout 2. AvoPay creates a non-custodial Boltz reverse swap routing the payment to your Liquid address 3. Funds arrive in your AQUA wallet automatically — no manual steps required #### Requirements * WooCommerce 8.0+ * Store currency set to EUR, USD, GBP, CAD, AUD, JPY, CHF, DKK, or BRL (additional currencies will be added over time) * An AvoPay account — register at avopay.dev * AQUA wallet by JAN3 (free, iOS and Android — aqua.net) #### Data and privacy Order payment data (swap IDs, invoice hashes, claim keys) is stored in WooCommerce order meta and is preserved when the plugin is uninstalled, as it constitutes a financial audit trail. Plugin configuration data (API key, wallet fingerprint, logs table) is deleted automatically on uninstall. An optional „Delete AvoPay data on uninstall“ setting is available in WooCommerce > Settings > Payments > AvoPay if you prefer full cleanup. ### External services This plugin connects to the following third-party services. By activating this plugin you acknowledge that data will be transmitted to these services as described below. #### AvoPay API The AvoPay API (api.avopay.dev) is the payment processing backbone. It handles fiat- to-sats conversion, Bitcoin address derivation, ephemeral keypair generation, and HTLC claim broadcasting. What data is sent: the merchant’s API key (used as an identifier), the WooCommerce order ID, the order amount, and the store currency. No customer personal data (name, email, address) is ever transmitted to this service. When it is sent: on every payment at checkout. [Privacy Policy](https://avopay.dev/privacy) · [Terms of Service](https://avopay.dev/terms) #### Boltz Exchange Boltz Exchange (api.boltz.exchange) is a non-custodial atomic swap provider. AvoPay uses it to create Lightning-to-Liquid Bitcoin reverse swaps so payments are routed to the merchant’s self-custodial AQUA wallet. What data is sent: swap amount in satoshis, an ephemeral claim public key, a refund public key, and a generated swap ID. No customer personal data is transmitted. When it is sent: at payment creation (swap setup) and during settlement (status polling and cooperative claim). [Privacy Policy](https://boltz.exchange/privacy) · [Terms of Service](https://boltz.exchange/terms) #### Blockstream Esplora Blockstream’s public Esplora API (blockstream.info/liquid) is used to detect incoming Liquid Bitcoin (L-BTC) transactions when a customer pays via the L-BTC Direct payment tab. What data is sent: the merchant’s Liquid wallet address, to query whether an incoming transaction has been received. No customer personal data is transmitted. When it is sent: periodically while the customer has the L-BTC Direct tab open at checkout. [Privacy Policy](https://blockstream.com/privacy-policy) · [Terms of Service](https://blockstream.com/terms-of-service) #### CoinGecko CoinGecko (api.coingecko.com) provides live BTC exchange rates used to calculate the satoshi amount for each order. What data is sent: the store currency code only (e.g. „EUR“ or „USD“). No personal data is transmitted. When it is sent: at payment creation. [Privacy Policy](https://www.coingecko.com/en/privacy) · [Terms of Service](https://www.coingecko.com/en/terms) #### CoinCap CoinCap (api.coincap.io) is used as a fallback BTC rate source if CoinGecko is unavailable. What data is sent: no parameters; no personal data is transmitted. When it is sent: only if CoinGecko is unreachable at payment creation. [Privacy Policy](https://coincap.io/privacy) · [Terms of Service](https://coincap.io/terms) ### Credits This plugin includes qrcodejs, a JavaScript QR code generator. Original QR code algorithm by Kazuhiko Arase. JavaScript port: https://github.com/davidshimjs/qrcodejs Licensed under the MIT License. ## Screenshots [⌊WooCommerce checkout — Bitcoin appears as a payment option alongside standard methods⌉⌊WooCommerce checkout — Bitcoin appears as a payment option alongside standard methods⌉[ WooCommerce checkout — Bitcoin appears as a payment option alongside standard methods [⌊Order confirmation — Lightning invoice QR code displayed immediately after checkout⌉⌊ Order confirmation — Lightning invoice QR code displayed immediately after checkout⌉[ Order confirmation — Lightning invoice QR code displayed immediately after checkout [⌊Payment page — scannable Lightning QR with countdown timer and L-BTC fallback tab⌉⌊Payment page — scannable Lightning QR with countdown timer and L-BTC fallback tab⌉[ Payment page — scannable Lightning QR with countdown timer and L-BTC fallback tab [⌊Setup step 1 — paste your AvoPay API key to connect your account⌉⌊Setup step 1— paste your AvoPay API key to connect your account⌉[ Setup step 1 — paste your AvoPay API key to connect your account [⌊Setup step 2 — scan the QR code with your AQUA wallet to link your Bitcoin address⌉⌊ Setup step 2 — scan the QR code with your AQUA wallet to link your Bitcoin address⌉[ Setup step 2 — scan the QR code with your AQUA wallet to link your Bitcoin address [⌊Setup step 3 — send a test payment to verify the full payment flow end-to-end⌉⌊ Setup step 3 — send a test payment to verify the full payment flow end-to-end⌉[ Setup step 3 — send a test payment to verify the full payment flow end-to-end [⌊AvoPay dashboard — manage your account, subscription, and payment links at avopay. dev⌉⌊AvoPay dashboard — manage your account, subscription, and payment links at avopay.dev⌉[ AvoPay dashboard — manage your account, subscription, and payment links at avopay. dev ## Installation 1. In your WordPress admin, go to Plugins > Add New Plugin 2. Search for „AvoPay Bitcoin for WooCommerce“ 3. Click Install Now, then Activate 4. Go to WooCommerce > Settings > Payments > AvoPay and enable the payment method 5. Navigate to WooCommerce > AvoPay to complete the 3-step setup: 6. * Create a free account at avopay.dev and copy your API key * Paste your API key into the plugin to connect your account * Scan the QR code with your AQUA wallet to link your Bitcoin address * Send a test payment to verify everything works end-to-end ## FAQ ### Do I need to run a Bitcoin node? No. AvoPay uses Boltz Exchange for non-custodial Lightning to Liquid swaps. No node required. ### Where do funds go? Directly to your AQUA wallet. AvoPay never holds your funds. ### What wallet do I need? The AQUA wallet by JAN3 — free on iOS and Android at aqua.net. ### Are there chargebacks? No. Bitcoin payments are irreversible by design. ### Can I accept both cards and Bitcoin? Yes. AvoPay adds Bitcoin as one more payment method at checkout — it works alongside Stripe, PayPal, and any other WooCommerce gateway you already use. Customers who want to pay by card still can; nothing about your existing checkout changes. ### Which currencies are supported? Stores priced in EUR, USD, GBP, CAD, AUD, JPY, CHF, DKK, or BRL. The order total is converted to satoshis at the live BTC rate at checkout. Additional currencies will be added over time. ### What are the fees? AvoPay charges a flat subscription with no percentage transaction fee. A Boltz swap fee of roughly 0.25% plus a small network fee applies at settlement — charged by Boltz, not AvoPay. Your first 5 payments are free. ### What happens if the AvoPay service is unreachable? New Bitcoin payments fail gracefully — the customer sees a standard payment error and can complete the order with any other payment method you offer. Orders that have already been paid are never lost: Boltz retries settlement webhooks, and the plugin’s own cron re-checks every pending order once a minute until settlement is verified. Because funds settle wallet-to-wallet, your money is never held by AvoPay at any point. ### What happens to my data if I uninstall the plugin? Plugin configuration (API key, logs, wallet connection) is deleted automatically. WooCommerce order payment data is preserved by default as a financial audit record. You can enable full deletion under WooCommerce > Settings > Payments > AvoPay before uninstalling. ## Rezensionen ![](https://secure.gravatar.com/avatar/b42e0f06d95f0caab57b425edf2698d037bfdbb37318ee102059d3f0a20addaa? s=60&d=retro&r=g) ### 󠀁[Super simple to add Bitcoin as payment method](https://wordpress.org/support/topic/super-simple-to-add-bitcoin-as-payment-method/)󠁿 [mikenie](https://profiles.wordpress.org/mikenie/) 30. Juni 2026 Setup was incredibly simple. No code changes needed, zero KYC hassle, and it just works right out of the box. Simply put a Bitcoin payment method next to Credit Card option from Stripe. All income from sales to my self-custodial wallet. Awesome work! ![](https://secure.gravatar.com/avatar/897e954c7f806bf8719c5adca92367c69d1ab2c1f69d386769df09302fa5e0dd? s=60&d=retro&r=g) ### 󠀁[Great plugin](https://wordpress.org/support/topic/great-plugin-41545/)󠁿 [nataliadelboux](https://profiles.wordpress.org/nataliadelboux/) 3. Juni 2026 This plugin is great and does exactly what it promises. The installation was extremely easy, and the setup is very intuitive with no complications. I highly recommend. [ Alle 2 Rezensionen lesen ](https://wordpress.org/support/plugin/avopay-bitcoin-for-woocommerce/reviews/) ## Mitwirkende und Entwickler „AvoPay Bitcoin for WooCommerce“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt: Mitwirkende * [ avopaydev ](https://profiles.wordpress.org/avopaydev/) [Übersetze „AvoPay Bitcoin for WooCommerce“ in deine Sprache.](https://translate.wordpress.org/projects/wp-plugins/avopay-bitcoin-for-woocommerce) ### Interessiert an der Entwicklung? [Durchstöbere den Code](https://plugins.trac.wordpress.org/browser/avopay-bitcoin-for-woocommerce/), sieh dir das [SVN-Repository](https://plugins.svn.wordpress.org/avopay-bitcoin-for-woocommerce/) an oder abonniere das [Entwicklungsprotokoll](https://plugins.trac.wordpress.org/log/avopay-bitcoin-for-woocommerce/) per [RSS](https://plugins.trac.wordpress.org/log/avopay-bitcoin-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss). ## Änderungsprotokoll #### 1.0.26 * Fix: an on-chain Bitcoin payment that ran into a problem (wrong amount sent, or a delayed internal confirmation) previously showed „Payment returned“ at checkout. In both cases nothing had actually been returned yet, so the message could read as reassuring when it wasn’t. Checkout now shows „Payment issue — please contact support“ instead. #### 1.0.25 * Improvement: if your AvoPay account email is not yet verified, saving the API key or starting the setup test payment now shows a clear notice with a link to your avopay.dev dashboard to resend the verification email, instead of a generic error. AvoPay requires a verified email before an account can accept payments. #### 1.0.24 * Improvement: as soon as a payment is detected on the network, the QR code, address, and copy buttons now disappear from the checkout page — only the live status remains. Previously the QR stayed on screen next to „payment detected“ messages, which could invite a second payment. Applies to all three payment options (Lightning, Liquid, on-chain Bitcoin). * Improvement: once a payment is detected, the payment-method tabs are hidden so a buyer can no longer switch to another method and accidentally pay twice while the first payment confirms. * Improvement: the setup test payment behaves the same way — after a Liquid payment is detected, the test QR codes and tabs disappear while it waits for confirmation. #### 1.0.23 * Fix: when a Bitcoin payment could not be started for a permanent reason — most often an order total below the Bitcoin minimum, or a store currency AvoPay does not support — checkout showed „Payment temporarily unavailable. Please try again.“, inviting a retry that could never succeed. The real reason is now shown instead, so the shopper and the store owner can see what to change. Genuine temporary problems still show the retry message. * Wording: the Liquid payment tab now highlights the amount as „1,234 sats of L- BTC“ above the QR code, and the separate note about other Liquid assets at the bottom of the tab has been removed. #### 1.0.22 * Improvement: instant Liquid (L-BTC) settlement now works out of the box — the settlement push is authenticated with the key created automatically when you connect your wallet, so the manual AVOPAY_INTERNAL_CLAIM_SECRET wp-config.php constant is no longer required (still accepted if already set). * Wording: the payment method is now presented as „Bitcoin“ rather than „Bitcoin Lightning“, reflecting that AvoPay accepts Lightning, Liquid (L-BTC), and on- chain Bitcoin. Lightning remains one of the three payment options at checkout. #### 1.0.21 * Improvement: the Liquid payment tab now warns buyers to send L-BTC (Liquid Bitcoin) only — other Liquid assets such as USDT arrive in the merchant wallet but are not detected as payment for the order. * Improvement: the setup test payment now settles through the same pipeline as real orders — success shows within seconds of paying (previously it could take several minutes), and the funds claim runs on the AvoPay server so a slow website can no longer delay it. * Feature: the test payment offers a second Liquid (L-BTC) direct tab, verified with the same cryptographic settlement checks as real Liquid payments. * Improvement: the AvoPay dashboard now shows a notice when a newer plugin version is available, with a one-click „Update now“ link — no need to check the Plugins page. The check runs server-side and is cached for six hours. #### 1.0.20 * Fix: checkout could show a fatal PHP error („Call to a member function get_total() on false“) when WooCommerce was unable to load the order while starting a Bitcoin payment. The gateway now fails gracefully with a clear „please refresh and try again“ notice instead of a white screen. * Improvement: when an order can’t be loaded at payment start, the cause is now logged with context (WooCommerce version, HPOS on/off, plugin version) to speed up diagnosis. #### 1.0.19 * Feature: L-BTC (Liquid) payments now settle via instant server push — orders are marked paid moments after the first Liquid confirmation instead of waiting for the polling cron. The cron remains as an automatic fallback. * Feature: the checkout page now shows „Payment detected — waiting for first Liquid confirmation“ as soon as an L-BTC payment is seen on the network. * Improvement: wallet reconnects that would strand in-flight L-BTC payments are now blocked by the AvoPay server; the dashboard shows the reason instead of failing silently. * Improvement: the L-BTC status poll settles faster (every minute instead of up to five). * Security: cron endpoints now accept the authentication header only — the legacy? secret= URL fallback was removed. #### 1.0.18 * Security: L-BTC (Liquid) payments now settle through the shared cryptographic verifier — the confidential amount and asset are verified and one Liquid confirmation is required before an order is marked paid. * Security: removed the plugin’s independent on-chain detection path, which was blind to confidential amounts; WooCommerce now delegates to the same settlement implementation used by the AvoPay API (one verifier, no duplicate logic). #### 1.0.16 * Feature: optional Bitcoin on-chain payment tab via Boltz chain swaps (BTCL-BTC atomic swap); enabled per-merchant in the AvoPay dashboard; minimum order 25,000 sats * UX: payment tab order changed to Lightning Bitcoin Onchain Liquid across the checkout page * UX: tab labels renamed — „L-BTC Direct“ „Liquid“, „Bitcoin“ „Bitcoin Onchain“; emoji removed from all tab labels #### 1.0.15 * Maintenance: version number now correctly reflected in plugin header (was stuck at 1.0.12 since v1.0.1 due to release tooling bug) #### 1.0.14 * Maintenance: release tooling corrected; no plugin behaviour changes #### 1.0.13 * Fix: PHP fatal error on cron backstop caused by stale interface declarations ( broken since v1.0.1) * Fix: retry payment button now calls the API correctly instead of a removed local method (broken since v1.0.1) * Fix: „Tested up to“ updated to WordPress 7.0 — restores search visibility on WP.org * Code: Plugin Check 0 errors, 0 warnings #### 1.0.12 * Fix: payment card now renders above order details and billing address on WooCommerce Blocks checkout * UX: checkout QR card redesigned — white background for scanner compatibility, reduced size, dark theme * UX: payment prompt text added above Lightning invoice („Please complete the Lightning payment below to finalise your order.“) * UX: Lightning QR reduced from 380px to 220px — still fully scannable, page no longer requires scrolling to see order details * UX: payment method icon updated to Bitcoin logo; description updated to „Pay from any Bitcoin Lightning wallet“ * UX: admin dashboard header updated with AvoPay logo and Bitcoin menu icon * Marketplace: installation instructions updated for WordPress.org — no manual ZIP download required #### 1.0.11 * Compliance: move „External services“ to a standalone top-level readme section with full data-sent descriptions and Privacy + Terms links for all five services * Security: payment status polling endpoints now require a per-order poll token( generated at checkout, verified server-side) — prevents unauthenticated enumeration of order status #### 1.0.10 * Feature: merchant-absorbs-fees across all payment channels #### 1.0.5 * Copy: step 3 title, description, and button text updated for clarity #### 1.0.4 * Fix: admin dashboard now passes correct `licensed` property to JS (fixes step 2 auto-QR load and step 3 test payment display) #### 1.0.3 * Compliance: remove custom update checker (WP.org guideline — updates served from WP.org) * Compliance: rename plugin slug to avopay-bitcoin-for-woocommerce (WooCommerce trademark policy) * Code: replace date(), parse_url(), strip_tags() with WP equivalents gmdate(), wp_parse_url(), wp_strip_all_tags() * Code: add wp_unslash() before all sanitize_text_field() calls on superglobals * Code: add ordered placeholders (%1$s) and translators comments in all translatable strings * Code: remove development error_log() call #### 1.0.2 * Fix: site domain now registered with AvoPay on API key activation so client dashboard shows correct domain #### 1.0.1 * Compliance: payment creation logic moved server-side; plugin is now a thin API connector (no local trial counter or gateway disable) * Compliance: inline script and style tags replaced with wp_add_inline_script / wp_add_inline_style * Security: input sanitization added for CONTENT_TYPE, POST keys, and JSON payload version field * Docs: external service Terms and Privacy links added for CoinGecko, CoinCap, and Blockstream Esplora #### 1.0.0 * WordPress.org release * Added: optional „Delete AvoPay data on uninstall“ setting (default: off, preserves order financial records) * Improved: full uninstall cleanup of plugin options, logs table, and cron jobs * Improved: activation table creation uses dbDelta for safe upgrades #### 0.5.19 * Fix: test payment stops at transaction.mempool with live wait counter * UX: step 2 connected + date merged into single pill * UX: step 3 success state split into green banner and neutral info box #### 0.5.18 * Security: rate limiting on all API routes * Security: JWT token_version revocation — stale tokens rejected immediately * Security: CORS locked down to avopay.dev domains * Security: OTP log suppression in Nginx access logs * Security: startup env validation — API exits on missing required vars #### 0.5.17 * Fix: claim fee bumping on retry (RBF — 500 to 750 to 1000 sats/vbyte) #### 0.5.16 * Feature: invoice.settled status marks order paid instantly * Improvement: decoupled claim trigger from webhook handler * Improvement: adaptive JS polling (1s x 15 then 3s) * Improvement: API secondary poll via open-CORS swap status endpoint * Fix: double payment email on fast settlements #### 0.5.15 * Feature: relay architecture — API-side callback delivery with retry queue * Feature: swap_registry table tracks full lifecycle per swap #### 0.5.14 * Feature: server-side callback delivery via AvoPay API #### 0.5.13 * Fix: WP cron backstop age guard skips orders younger than 2 minutes #### 0.5.12 * Feature: slow payment watchdog — 30 min delay email and 120 min manual review flag #### 0.5.11 * Feature: Hetzner cron backstop every 5 min for stuck pending orders #### 0.5.10 * Feature: L-BTC direct payment tab — customer can pay from any Liquid wallet #### 0.5.9 * Fix: test payment 500 error — removed stale descriptor method calls * Fix: step 2 QR and step 3 test payment now show error feedback on AJAX failure #### 0.5.8 * Fix: claim broadcaster now works on any hosting environment * Fix: empty PHP files replaced to prevent security scanner false positives #### 0.5.7 * Feature: server-side SLIP-0077 address derivation via AvoPay API * Change: vendor directory removed — zero PHP dependencies #### 0.5.6 * Feature: L-BTC direct payment support * Feature: retry flow (max 3 attempts) #### 0.5.5 * Feature: PM2 graceful shutdown * Feature: claim retry queue with backoff #### 0.5.4 * Initial public release ## Meta * Version **1.0.26** * Zuletzt aktualisiert **vor 3 Monaten** * Aktive Installationen **weniger als 10** * WordPress-Version ** 6.0 oder höher ** * Getestet bis **7.0.7** * PHP-Version ** 8.0 oder höher ** * Sprache * [English (US)](https://wordpress.org/plugins/avopay-bitcoin-for-woocommerce/) * Schlagwörter * [bitcoin](https://de.wordpress.org/plugins/tags/bitcoin/)[bitcoin payments](https://de.wordpress.org/plugins/tags/bitcoin-payments/) [crypto payments](https://de.wordpress.org/plugins/tags/crypto-payments/)[Lightning](https://de.wordpress.org/plugins/tags/lightning/) [payment gateway](https://de.wordpress.org/plugins/tags/payment-gateway/) * [Erweiterte Ansicht](https://de.wordpress.org/plugins/avopay-bitcoin-for-woocommerce/advanced/) ## Bewertungen 5 von 5 Sternen. * [ 2 5-Sterne-Rezensionen ](https://wordpress.org/support/plugin/avopay-bitcoin-for-woocommerce/reviews/?filter=5) * [ 0 4-Sterne-Rezensionen ](https://wordpress.org/support/plugin/avopay-bitcoin-for-woocommerce/reviews/?filter=4) * [ 0 3-Sterne-Rezensionen ](https://wordpress.org/support/plugin/avopay-bitcoin-for-woocommerce/reviews/?filter=3) * [ 0 2-Sterne-Rezensionen ](https://wordpress.org/support/plugin/avopay-bitcoin-for-woocommerce/reviews/?filter=2) * [ 0 1-Sterne-Rezensionen ](https://wordpress.org/support/plugin/avopay-bitcoin-for-woocommerce/reviews/?filter=1) [Deine Rezension](https://wordpress.org/support/plugin/avopay-bitcoin-for-woocommerce/reviews/#new-post) [Alle Rezensionen anzeigen](https://wordpress.org/support/plugin/avopay-bitcoin-for-woocommerce/reviews/) ## Mitwirkende * [ avopaydev ](https://profiles.wordpress.org/avopaydev/) ## Support Möchtest du etwas mitteilen? Brauchst du Unterstützung? [Support-Forum anzeigen](https://wordpress.org/support/plugin/avopay-bitcoin-for-woocommerce/)