About this plugin
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.
dev/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
- Customer selects Bitcoin at checkout
- AvoPay creates a non-custodial Boltz reverse swap routing the payment to your Liquid address
- 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
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 · Terms of Service
Boltz Exchange
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 · Terms of Service
Blockstream Esplora
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 · Terms of Service
CoinGecko
com) provides live BTC exchange rates used to calculate the satoshi amount for each order.
g. “EUR” or “USD”). No personal data is transmitted.
When it is sent: at payment creation.
Privacy Policy · Terms of Service
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 · Terms of Service
Credits
This plugin includes qrcodejs, a JavaScript QR code generator.
Original QR code algorithm by Kazuhiko Arase.
com/davidshimjs/qrcodejs
Licensed under the MIT License.