WordPress.org
Get WordPress
WordPress.org

Plugin Directory

BTC Checkout — Bitcoin Payment Gateway for WooCommerce

BTC Checkout — Bitcoin Payment Gateway for WooCommerce

By joelledesma
Download

Description

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.

Blockchain.info API

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

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.

Screenshots

  • BTC Checkout payment option on the WooCommerce checkout page.
  • Admin settings panel — configure wallet addresses and payment options.
  • QR code payment screen shown to customers after placing an order.
  • Order details showing Bitcoin payment verification status.

Installation

Automatic Installation

  1. Log in to your WordPress dashboard.
  2. Navigate to Plugins Add New.
  3. Search for “BTC Checkout”.
  4. Click Install Now, then Activate.
  5. Go to WooCommerce Settings Payments BTC Checkout to configure your wallet address.

Manual Installation

  1. Download the plugin ZIP file from the WordPress plugin directory.
  2. Log in to your WordPress dashboard.
  3. Navigate to Plugins Add New Upload Plugin.
  4. Choose the downloaded ZIP file and click Install Now.
  5. Click Activate Plugin.
  6. Go to WooCommerce Settings Payments BTC Checkout to configure your wallet address.

Minimum Requirements

  • WordPress 5.8 or higher
  • WooCommerce 5.0 or higher
  • PHP 8.1 or higher
  • SSL certificate (HTTPS) recommended for secure checkout

Configuration

  1. Navigate to WooCommerce Settings Payments.
  2. Click Manage next to “BTC Checkout”.
  3. Enter your Bitcoin wallet address.
  4. Configure optional settings:
    • Payment confirmation threshold
    • Bitcoin discount percentage
    • Order status after payment
    • Payment timeout duration
  5. Click Save Changes.

FAQ

Is BTC Checkout free?

Yes! Bitcoin (BTC) payments are completely free. There are no transaction fees, no monthly costs, and no limits.

Do I need a third-party account?

No. BTC Checkout is fully self-hosted. Payments go directly to your wallet address. There is no account registration and no KYC verification required.

How are payments verified?

BTC Checkout uses public blockchain APIs to verify payments in real time. When a customer sends a payment, the plugin monitors the blockchain for the transaction and automatically updates the order status once the required number of confirmations is reached.

What happens if a customer underpays?

If a customer sends less than the required amount, the order remains in “Pending Payment” status. You can configure the plugin to allow a tolerance percentage for minor rounding differences.

Is it compatible with the WooCommerce block checkout?

Yes. BTC Checkout works with both the classic WooCommerce checkout and the newer block-based checkout editor.

Does it work with WooCommerce HPOS (High-Performance Order Storage)?

Yes. BTC Checkout is fully compatible with WooCommerce HPOS.

Can I offer discounts for Bitcoin payments?

Yes. You can configure a percentage or fixed-amount discount for customers who choose to pay with Bitcoin. A “Save X%” badge is displayed at checkout to incentivize Bitcoin payments.

Is the plugin secure?

Yes. BTC Checkout includes input sanitization, nonce verification, CSRF protection, and rate limiting. No sensitive data (private keys, card numbers) is ever stored or transmitted.

Where can I get support?

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

Reviews

There are no reviews for this plugin.

Contributors & Developers

“BTC Checkout — Bitcoin Payment Gateway for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

Translate “BTC Checkout — Bitcoin Payment Gateway 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

2.4.0

  • New: Redesigned admin order metabox with large crypto amount display, color-coded status badges, and clean payment address card.
  • New: Redesigned frontend payment card with dominant BTC amount hero, horizontal QR + fields layout, and improved CTA button.
  • New: Elementor compatibility tag added to plugin header.
  • Improved: Admin metabox uses BEM-style CSS architecture (cc- prefix) for zero-conflict styling.
  • Improved: Frontend payment card uses BEM-style CSS architecture (cc-pay prefix) for zero-conflict styling.
  • Improved: Copy-to-clipboard and blockchain explorer buttons with inline SVG icons.
  • Improved: Grouped trust section with blockchain verification footer.

2.1.5

  • Security: Replaced direct SQL queries with WooCommerce-native wc_get_orders() for Plugin Check compliance.
  • Security: Added rate limiting to all frontend AJAX endpoints (payment status check and manual verify).
  • Security: Added explicit capability check in bulk actions handler (edit_shop_orders).
  • Security: Added nonce/referer verification to bulk order actions for CSRF defense-in-depth.
  • Security: Added absint() normalization for order IDs in bulk action processing.
  • Security: Upgraded Bitcoin address validation with full Bech32/Bech32m checksum verification (BIP-173/BIP-350).
  • Security: Added heartbeat token format validation before HMAC comparison.
  • Improved: Added user-facing error feedback when payment status check fails.
  • Improved: Added admin notice when neither bcmath nor gmp PHP extensions are available.
  • Improved: Enhanced bcmath diagnostics logging with GMP status.
  • Fixed: Deprecated current_time(‘timestamp’) replaced with time().
  • Fixed: Removed unused global $wpdb reference in admin class.
  • i18n: All new strings are translation-ready with proper text domain.

2.1.4

  • Refreshed the admin dashboard and order payment UI for faster review and a more polished first impression.
  • Added clearer payment status badges, stronger empty states, and better manual check feedback.

2.1.2

  • Fixed: CoinGecko external service documentation updated with Trust Center and API documentation links for reliable access.
  • Fixed: All transient keys now use full crypto_checkout_hb_ prefix instead of abbreviated cc_hb_ prefix (WordPress.org naming compliance).
  • Fixed: JavaScript localization object names updated to btcCheckoutParams and btcCheckoutHeartbeat for consistent prefixing.
  • Fixed: Uninstall cleanup updated to match new transient key naming.
  • Removed: Stale legacy references from changelog entries.

2.1.1

  • Fixed: Refactored inline JavaScript to external enqueued file (WordPress.org compliance).
  • Fixed: Consolidated duplicate AJAX payment check handlers into single reusable script.
  • Improved: Dashboard order counts now cached with 5-minute transient for better performance.
  • Improved: Custom message sanitization uses wp_kses instead of wp_strip_all_tags to preserve basic formatting.
  • Improved: All translatable strings in admin JS now passed via wp_localize_script.
  • Updated: readme.txt tags updated to bitcoin-focused keywords.

2.1.0

  • Added: Payment Tracking Dashboard — dedicated WooCommerce admin screen showing pending, confirmed, and expired Bitcoin orders at a glance.
  • Added: Manual Payment Verification — one-click “Check Now” button on pending orders to re-verify blockchain payment status on demand.
  • Added: Customizable Payment Instructions — configure the payment page heading, instructions text, and confirmation message from WooCommerce settings without editing code.
  • Added: Token replacement system for payment messages — use {amount}, {currency}, {address}, and {timeout} placeholders.
  • Improved: Admin order list now shows crypto payment status column with color-coded badges.

2.0.9

  • Improved: Currency selector badge hidden in free (BTC-only) mode to avoid redundant “Bitcoin” labeling at checkout.
  • Improved: Badge only renders when multiple currencies are enabled.

2.0.8

  • Improved: All user-facing strings updated from “Crypto Checkout” to “BTC Checkout” for consistent BTC-only branding.
  • Improved: Admin notices, settings labels, security emails, and privacy strings now reference Bitcoin instead of generic cryptocurrency.
  • Improved: Code comments updated across all files for reviewer trust and consistency.
  • Improved: Changelog entries simplified to remove unnecessary altcoin references.

2.0.7

  • Removed: Unused icon asset.
  • Simplified: QR code URI generation — removed unnecessary switch/case for BTC-only plugin.
  • Rewritten: README.md updated to BTC-only content (removed outdated multi-coin documentation).

2.0.6

  • Removed: Unnecessary load_plugin_textdomain() call (WordPress.org handles translations automatically since WP 4.6).
  • Removed: Legacy multi-coin code from security, gateway, privacy, QR, and uninstall files.
  • Changed: WooCommerce method_title updated to “BTC Checkout” for consistent naming.
  • Cleaned: Debug comments removed from gateway code.
  • Improved: Readme and changelog cleaned for BTC-only consistency.

2.0.5

  • Fixed text domain to match WordPress.org assigned slug (btc-checkout)
  • Renamed main plugin file to btc-checkout.php for slug consistency
  • Regenerated translation template (.pot) file

2.0.4

  • Fixed: Text domain updated to match WordPress.org assigned slug (btc-checkout-crypto-payment-gateway-for-woocommerce).
  • Fixed: Translation template (.pot) renamed and updated to match new text domain.
  • Plugin Check: 0 errors, 0 warnings.

2.0.3

  • Removed: All legacy upsell references from plugin source code, settings descriptions, and readme.
  • Removed: Legacy upgrade notice section from WooCommerce payment gateway settings.
  • Regenerated: Clean translation template (.pot) with no stale strings.
  • Improved: All user-facing text now accurately reflects free version capabilities.

2.0.2

  • Removed: Empty legacy WooCommerce settings tab. All BTC settings remain accessible via WooCommerce Settings Payments BTC Checkout.
  • Improved: Cleaner admin interface with no redundant menu items.

2.0.1

  • Changed: Focused on Bitcoin (BTC) support.
  • Changed: Requires PHP 8.1 (aligned with bundled BaconQrCode library requirements).
  • Removed: License key system from free version.
  • Removed: Legacy multi-coin code (payment checker methods, currency definitions, checkout UI).
  • Added: Requires Plugins: woocommerce header for WordPress 6.5+ dependency management.
  • Added: Full external service documentation in readme.txt per WordPress.org guidelines.
  • Improved: Clean BTC-only checkout display (no unnecessary currency selector).
  • Changed: Cloudflare IP detection now uses bundled ranges only (no remote fetching).
  • Changed: Contributors field updated to match WordPress.org username.
  • Improved: Code quality and documentation throughout.

1.9.2

  • Fixed: Text domain corrected across all 254 translatable strings for WordPress.org compliance.
  • Improved: Heartbeat Protection interval optimized from 5s to 10s to reduce server load.
  • Improved: Heartbeat token storage switched from full order save to lightweight meta update.
  • Added: Cron overlap guard with transient-based lock to prevent concurrent payment verification runs.

1.9.1

  • Added: BCMath polyfill for hosts without the bcmath PHP extension.
  • Added: Enhanced security class with input sanitization, nonce verification, and rate limiting.
  • Improved: Precision math for payment calculations.

1.9.0

  • Replaced bundled phpqrcode library with BaconQrCode (BSD-2-Clause) for WordPress.org compliance.
  • Eliminated all unprefixed class and constant warnings.
  • Added SVG fallback renderer for hosts without GD extension.

1.8.0

  • Added: Frontend Heartbeat Protection to prevent wallet address swap attacks at checkout.
  • Added: HMAC-SHA256 per-order signature system for cryptographic address verification.
  • Added: MutationObserver-based instant DOM tampering detection.
  • Security: Timing-safe hash comparison to prevent side-channel attacks.

1.7.0

  • Added: Privacy policy integration via wp_add_privacy_policy_content() for GDPR compliance.
  • Added: Personal data exporter and eraser for WordPress privacy tools.
  • Added: Proper uninstall.php for clean plugin removal.
  • Added: Full internationalization support with .pot translation template.

1.6.0

  • Added: Multi-wallet address support with automatic round-robin load balancing.
  • Improved: Wallet address validation.
  • Improved: Exchange rate caching and fallback logic.

1.5.0

  • Added: Multi-wallet address rotation.
  • Improved: Exchange rate caching and fallback logic.

1.4.0

  • Added: Crypto discount incentive system.
  • Improved: QR code generation with amount encoding.
  • Improved: Block checkout compatibility.

1.3.0

  • Added: Configurable blockchain confirmation thresholds.
  • Improved: Payment verification reliability with retry logic.

1.2.0

  • Added: Payment timeout configuration.
  • Improved: WooCommerce HPOS compatibility.

1.1.0

  • Added: Real-time exchange rate conversion via CoinGecko API.
  • Improved: Checkout page styling and mobile responsiveness.

1.0.0

  • Initial release.
  • Bitcoin (BTC) payment support.
  • Automatic blockchain payment verification.
  • QR code generation for checkout.
  • WooCommerce Payment Gateway API integration.

Meta

Ratings

No reviews have been submitted yet.

Add my review

See all reviews

Contributors

Support

Got something to say? Need help?

View support forum

Donate

Would you like to support the advancement of this plugin?

Donate to this plugin