Title: BTC Checkout — Bitcoin Payment Gateway for WooCommerce Author: joelledesma Published: 21 مارس 2026 Last modified: 26 مارس 2026 --- جستجوی افزونه‌ها ![](https://ps.w.org/btc-checkout/assets/banner-772x250.png?rev=3487866) ![](https://ps.w.org/btc-checkout/assets/icon-256x256.png?rev=3491501) # BTC Checkout — Bitcoin Payment Gateway for WooCommerce توسط [joelledesma](https://profiles.wordpress.org/joelledesma/) [دانلود](https://downloads.wordpress.org/plugin/btc-checkout.2.4.0.zip) * [جزئیات](https://fa.wordpress.org/plugins/btc-checkout/#description) * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/btc-checkout/#reviews) * [نصب](https://fa.wordpress.org/plugins/btc-checkout/#installation) * [توسعه](https://fa.wordpress.org/plugins/btc-checkout/#developers) [پشتیبانی](https://wordpress.org/support/plugin/btc-checkout/) ## توضیحات **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) ### 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. ## عکس‌های صفحه * [[ * 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. ## نصب #### 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: 5. * Payment confirmation threshold * Bitcoin discount percentage * Order status after payment * Payment timeout duration 6. Click **Save Changes**. ## سوالات متداول ### 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. ## نقد و بررسی‌ها نقد و بررسی‌ای برای این افزونه یافت نشد. ## توسعه دهندگان و همکاران “BTC Checkout — Bitcoin Payment Gateway for WooCommerce” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند. مشارکت کنندگان * [ joelledesma ](https://profiles.wordpress.org/joelledesma/) [ترجمه “BTC Checkout — Bitcoin Payment Gateway for WooCommerce” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/btc-checkout) ### علاقه‌ مند به توسعه هستید؟ [Browse the code](https://plugins.trac.wordpress.org/browser/btc-checkout/), check out the [SVN repository](https://plugins.svn.wordpress.org/btc-checkout/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/btc-checkout/) by [RSS](https://plugins.trac.wordpress.org/log/btc-checkout/?limit=100&mode=stop_on_copy&format=rss). ## گزارش تغییرات #### 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. ## اطلاعات * نگارش **2.4.0** * Last updated **2 هفته پیش** * نصب‌های فعال **کمتر از 10** * نگارش وردپرس ** 5.8 یا بالاتر ** * Tested up to **6.9.4** * نگارش PHP ** 8.1 یا بالاتر ** * زبان * [English (US)](https://wordpress.org/plugins/btc-checkout/) * Tags * [bitcoin](https://fa.wordpress.org/plugins/tags/bitcoin/)[btc](https://fa.wordpress.org/plugins/tags/btc/) [payment gateway](https://fa.wordpress.org/plugins/tags/payment-gateway/)[self hosted](https://fa.wordpress.org/plugins/tags/self-hosted/) [woocommerce](https://fa.wordpress.org/plugins/tags/woocommerce/) * [نمایش پیشرفته](https://fa.wordpress.org/plugins/btc-checkout/advanced/) ## امتیازها هنوز هیچ نقدی ارسال نشده است. [Your review](https://wordpress.org/support/plugin/btc-checkout/reviews/#new-post) [مشاهده همه بررسی‌ها](https://wordpress.org/support/plugin/btc-checkout/reviews/) ## مشارکت کنندگان * [ joelledesma ](https://profiles.wordpress.org/joelledesma/) ## پشتیبانی چیزی برای گفتن دارید؟ نیاز به کمک دارید؟ [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/btc-checkout/) ## کمک مالی آیا تمایل دارید از پیشرفت این افزونه حمایت کنید؟ [ کمک مالی به این افزونه ](https://btccheckout.ai)