BTC Checkout — Bitcoin Payment Gateway for WooCommerce

BTC Checkout is a lightweight, self-hosted Bitcoin payment gateway for WooCommerce. Payments go directly to your wallet — no middlemen, no third-party fees, and no KYC required. Your keys, your coins.

Why BTC Checkout?

• Self-Hosted & Secure — Payments go directly to your wallet address. No third-party service holds your funds.
• Lightweight & Fast — Minimal footprint. Zero impact on Core Web Vitals or page load speed.
• Real-Time Verification — Automatic blockchain verification via public APIs. Orders are confirmed without manual checking.
• No KYC Required — Accept Bitcoin payments without identity verification or account registration.
• WooCommerce Native — Built on the WooCommerce Payment Gateway API. Works with both classic and block checkout. HPOS compatible.

Supported Cryptocurrencies

• Bitcoin (BTC)

Key Features

• Direct Wallet Payments — Customers pay directly to your Bitcoin wallet address.
• Automatic Order Verification — Blockchain-based payment verification updates order status automatically.
• Admin Payment Dashboard — View pending, confirmed, and expired Bitcoin orders from a dedicated WooCommerce admin screen.
• Manual Payment Check — Re-check pending Bitcoin payments from the order screen or dashboard with one click.
• Custom Payment Messaging — Customize the customer-facing payment heading and instructions without touching code.
• Bitcoin Discount Incentives — Offer percentage or fixed-amount discounts to customers who pay with Bitcoin. Displays a “Save X%” badge at checkout.
• Multi-Wallet Support — Configure multiple wallet addresses per currency with automatic round-robin load balancing.
• QR Code Checkout — Auto-generated QR codes for easy mobile payments.
• Real-Time Exchange Rates — Converts order totals to BTC using live market rates from CoinGecko.
• Configurable Confirmations — Set the number of blockchain confirmations required before marking an order as complete.
• Enterprise Security — Input sanitization, nonce verification, CSRF protection, and rate limiting built in.
• Multilingual Ready — Translation-ready with full i18n support.

How It Works

1. Install the Plugin — Upload via WordPress dashboard or install from the plugin directory. Activate with one click.
2. Add Your Wallet — Enter your Bitcoin wallet address in WooCommerce → Settings → Payments → BTC Checkout.
3. Accept Payments — Customers pay with Bitcoin at checkout, send payment to your wallet, and the order is verified automatically.

Documentation

Full documentation is available at BTCCheckout.ai/docs.

Support

Open a support topic on the WordPress.org plugin support forum, or email support@btccheckout.ai.

External Services

This plugin connects to the following external services for payment verification and exchange rate data. No personal customer data is transmitted to any of these services — only public blockchain addresses and transaction lookups are performed.

CoinGecko API

Used to retrieve real-time Bitcoin exchange rates for converting WooCommerce order totals into the equivalent BTC amount.

• Service URL: https://www.coingecko.com
• API endpoint: https://api.coingecko.com/api/v3/simple/price
• Data sent: Currency identifier and fiat currency code (e.g., bitcoin, usd)
• Terms of Service & Privacy Policy: https://trust.coingecko.com/resources
• API Documentation: https://docs.coingecko.com

Blockchain.info API

Used to verify Bitcoin (BTC) payments by checking recent transactions for the configured wallet address.

• Service URL: https://www.blockchain.com
• API endpoint: https://blockchain.info/rawaddr/{address}
• Data sent: Bitcoin wallet address (public, already on the blockchain)
• Terms of Service: https://www.blockchain.com/legal/terms
• Privacy Policy: https://www.blockchain.com/legal/privacy

Upgrade Notices

2.0.1

Major update: Free version focused on Bitcoin. License key system removed. Clean BTC-only codebase. Recommended update for all users.

1.9.2

Performance and compliance update. Fixes text domain, optimizes Heartbeat Protection intervals, adds cron overlap protection.

1.9.0

Replaces phpqrcode with BaconQrCode for WordPress.org compliance. Recommended update.

1.8.0

Critical security update: Adds Frontend Heartbeat Protection to prevent wallet address swap attacks. Strongly recommended.