AvoPay Bitcoin for WooCommerce

AvoPay lets your WooCommerce store accept Bitcoin Lightning payments with zero chargebacks, no KYC, and no code changes required. Payments settle directly to your self-custodial AQUA wallet — no middleman, no custodian.

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 — any WooCommerce currency supported
• 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 Lightning 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+
• 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 · Terms of Service

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 · Terms of Service

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 · 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 · Terms of Service

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 · Terms of Service

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.