=== BTC Checkout — Bitcoin Payment Gateway for WooCommerce === Contributors: joelledesma Donate link: https://btccheckout.ai Tags: bitcoin, woocommerce, payment gateway, btc, self-hosted Requires at least: 5.8 Tested up to: 6.9 Stable tag: 2.4.0 Requires PHP: 8.1 Requires Plugins: woocommerce License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Accept Bitcoin payments on your WooCommerce store. Self-hosted, no third-party fees, no KYC. Your keys, your coins. == 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](https://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](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](https://trust.coingecko.com/resources) * **API Documentation:** [https://docs.coingecko.com](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](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](https://www.blockchain.com/legal/terms) * **Privacy Policy:** [https://www.blockchain.com/legal/privacy](https://www.blockchain.com/legal/privacy) == 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**. == Frequently Asked Questions == = 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. == Screenshots == 1. BTC Checkout payment option on the WooCommerce checkout page. 2. Admin settings panel — configure wallet addresses and payment options. 3. QR code payment screen shown to customers after placing an order. 4. Order details showing Bitcoin payment verification status. == 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. == 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.