{"id":152229,"date":"2022-02-07T13:31:02","date_gmt":"2022-02-07T13:31:02","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/btcpay-greenfield-for-woocommerce\/"},"modified":"2026-04-13T08:15:28","modified_gmt":"2026-04-13T08:15:28","slug":"btcpay-greenfield-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/mr.wordpress.org\/plugins\/btcpay-greenfield-for-woocommerce\/","author":18796145,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.7.5","stable_tag":"2.7.5","tested":"6.9.4","requires":"6.2","requires_php":"8.0","requires_plugins":null,"header_name":"BTCPay For Woocommerce V2","header_author":"BTCPay Server","header_description":"BTCPay Server is a free and open-source bitcoin payment processor which allows you to receive payments in Bitcoin and altcoins directly, with no fees, transaction cost or a middleman.","assets_banners_color":"92a59b","last_updated":"2026-04-13 08:15:28","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/btcpayserver.org\/donate\/","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/btcpay-greenfield-for-woocommerce\/","header_author_uri":"https:\/\/btcpayserver.org","rating":5,"author_block_rating":0,"active_installs":1000,"downloads":43818,"num_ratings":20,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.1.10":{"tag":"0.1.10","author":"ndeet","date":"2022-02-15 11:32:26"},"0.1.6":{"tag":"0.1.6","author":"ndeet","date":"2022-02-07 13:30:51"},"0.1.7":{"tag":"0.1.7","author":"ndeet","date":"2022-02-07 14:03:31"},"0.1.8":{"tag":"0.1.8","author":"ndeet","date":"2022-02-08 14:21:08"},"0.1.9":{"tag":"0.1.9","author":"ndeet","date":"2022-02-08 21:35:04"},"0.2.0":{"tag":"0.2.0","author":"ndeet","date":"2022-02-18 15:18:38"},"0.2.1":{"tag":"0.2.1","author":"ndeet","date":"2022-02-21 13:17:11"},"0.2.2":{"tag":"0.2.2","author":"ndeet","date":"2022-02-28 10:04:21"},"0.2.3":{"tag":"0.2.3","author":"ndeet","date":"2022-02-28 10:41:01"},"0.2.4":{"tag":"0.2.4","author":"ndeet","date":"2022-03-04 22:59:33"},"0.2.5":{"tag":"0.2.5","author":"ndeet","date":"2022-03-13 22:00:24"},"1.0.0":{"tag":"1.0.0","author":"ndeet","date":"2022-03-27 16:37:05"},"1.0.1":{"tag":"1.0.1","author":"ndeet","date":"2022-04-08 19:59:22"},"1.0.2":{"tag":"1.0.2","author":"ndeet","date":"2022-04-08 20:13:32"},"1.0.3":{"tag":"1.0.3","author":"ndeet","date":"2022-08-18 12:13:55"},"1.1.0":{"tag":"1.1.0","author":"ndeet","date":"2022-09-12 09:45:02"},"1.1.1":{"tag":"1.1.1","author":"ndeet","date":"2022-09-12 10:00:11"},"1.1.2":{"tag":"1.1.2","author":"ndeet","date":"2022-12-09 11:40:34"},"1.1.3":{"tag":"1.1.3","author":"ndeet","date":"2023-01-20 10:49:58"},"1.1.4":{"tag":"1.1.4","author":"ndeet","date":"2023-01-20 11:11:01"},"1.1.5":{"tag":"1.1.5","author":"ndeet","date":"2023-03-08 13:28:51"},"2.0.0":{"tag":"2.0.0","author":"ndeet","date":"2023-03-22 08:42:59"},"2.1.0":{"tag":"2.1.0","author":"ndeet","date":"2023-04-03 09:34:16"},"2.2.0":{"tag":"2.2.0","author":"ndeet","date":"2023-08-17 07:57:31"},"2.2.1":{"tag":"2.2.1","author":"ndeet","date":"2023-08-17 10:46:47"},"2.2.2":{"tag":"2.2.2","author":"ndeet","date":"2023-08-22 08:32:59"},"2.2.3":{"tag":"2.2.3","author":"ndeet","date":"2023-08-22 12:57:52"},"2.3.0":{"tag":"2.3.0","author":"ndeet","date":"2023-09-06 13:49:53"},"2.3.1":{"tag":"2.3.1","author":"ndeet","date":"2023-10-20 09:02:38"},"2.4.0":{"tag":"2.4.0","author":"ndeet","date":"2023-12-15 10:51:01"},"2.4.1":{"tag":"2.4.1","author":"ndeet","date":"2024-01-22 22:01:13"},"2.5.0":{"tag":"2.5.0","author":"ndeet","date":"2024-01-31 13:40:03"},"2.6.0":{"tag":"2.6.0","author":"ndeet","date":"2024-02-27 15:13:18"},"2.6.1":{"tag":"2.6.1","author":"ndeet","date":"2024-04-04 15:51:27"},"2.6.2":{"tag":"2.6.2","author":"ndeet","date":"2024-04-08 22:16:30"},"2.7.0":{"tag":"2.7.0","author":"ndeet","date":"2024-09-13 17:17:44"},"2.7.1":{"tag":"2.7.1","author":"ndeet","date":"2024-11-22 17:16:55"},"2.7.2":{"tag":"2.7.2","author":"ndeet","date":"2025-04-10 13:21:17"},"2.7.3":{"tag":"2.7.3","author":"ndeet","date":"2026-03-23 11:26:04"},"2.7.4":{"tag":"2.7.4","author":"ndeet","date":"2026-03-26 11:21:26"},"2.7.5":{"tag":"2.7.5","author":"ndeet","date":"2026-04-13 08:15:28"}},"upgrade_notice":{"2.7.5":"<ul>\n<li>Fix: Refunds: remove XMR from payment methods to not break refunds<\/li>\n<li>Fix: Blocks checkout: Improve blocks checkout detection<\/li>\n<li>Fix: Blocks checkout: Allow re-trigger on abort<\/li>\n<li>Fix: Blocks checkout: Ensure customer data form validation can&#039;t get skipped<\/li>\n<\/ul>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":20},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":2674285,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":2674285,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3025436,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3025436,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.10","0.1.6","0.1.7","0.1.8","0.1.9","0.2.0","0.2.1","0.2.2","0.2.3","0.2.4","0.2.5","1.0.0","1.0.1","1.0.2","1.0.3","1.1.0","1.1.1","1.1.2","1.1.3","1.1.4","1.1.5","2.0.0","2.1.0","2.2.0","2.2.1","2.2.2","2.2.3","2.3.0","2.3.1","2.4.0","2.4.1","2.5.0","2.6.0","2.6.1","2.6.2","2.7.0","2.7.1","2.7.2","2.7.3","2.7.4","2.7.5"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3025436,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3025436,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3025436,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3025436,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3025436,"resolution":"5","location":"assets","locale":""},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3025436,"resolution":"6","location":"assets","locale":""}},"screenshots":{"1":"Provides a Bitcoin \/ Lightning Network (and other) payment gateway on checkout.","2":"Your customers can pay by scanning the QR-Code with their wallet or copy and paste the receiving address.","3":"After successful payment the customers will get redirected to the order page. The order will be marked as paid automatically.","4":"On the settings form you can connect to your BTCPay Server instance by just entering the URL and clicking on \"Generate API Key\" button.","5":"You will get redirected to your BTCPay Server instance and just need to confirm the permissions of the API key. You will get redirected back to the settings form and the webhook will get set up automatically. You are ready to go.","6":"On BTCPay Server you have extensive reporting and accounting features."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1886,165327,158202,6593,286],"plugin_category":[45],"plugin_contributors":[164837,201621,165329],"plugin_business_model":[],"class_list":["post-152229","plugin","type-plugin","status-publish","hentry","plugin_tags-bitcoin","plugin_tags-btcpay-server","plugin_tags-lightning-network","plugin_tags-payment-gateway","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-kukks","plugin_contributors-ndeet","plugin_contributors-nicolasdorier","plugin_committers-ndeet"],"banners":{"banner":"https:\/\/ps.w.org\/btcpay-greenfield-for-woocommerce\/assets\/banner-772x250.png?rev=3025436","banner_2x":"https:\/\/ps.w.org\/btcpay-greenfield-for-woocommerce\/assets\/banner-1544x500.png?rev=3025436","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/btcpay-greenfield-for-woocommerce\/assets\/icon-128x128.png?rev=2674285","icon_2x":"https:\/\/ps.w.org\/btcpay-greenfield-for-woocommerce\/assets\/icon-256x256.png?rev=2674285","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/btcpay-greenfield-for-woocommerce\/assets\/screenshot-1.png?rev=3025436","caption":"Provides a Bitcoin \/ Lightning Network (and other) payment gateway on checkout."},{"src":"https:\/\/ps.w.org\/btcpay-greenfield-for-woocommerce\/assets\/screenshot-2.png?rev=3025436","caption":"Your customers can pay by scanning the QR-Code with their wallet or copy and paste the receiving address."},{"src":"https:\/\/ps.w.org\/btcpay-greenfield-for-woocommerce\/assets\/screenshot-3.png?rev=3025436","caption":"After successful payment the customers will get redirected to the order page. The order will be marked as paid automatically."},{"src":"https:\/\/ps.w.org\/btcpay-greenfield-for-woocommerce\/assets\/screenshot-4.png?rev=3025436","caption":"On the settings form you can connect to your BTCPay Server instance by just entering the URL and clicking on \"Generate API Key\" button."},{"src":"https:\/\/ps.w.org\/btcpay-greenfield-for-woocommerce\/assets\/screenshot-5.png?rev=3025436","caption":"You will get redirected to your BTCPay Server instance and just need to confirm the permissions of the API key. You will get redirected back to the settings form and the webhook will get set up automatically. You are ready to go."},{"src":"https:\/\/ps.w.org\/btcpay-greenfield-for-woocommerce\/assets\/screenshot-6.png?rev=3025436","caption":"On BTCPay Server you have extensive reporting and accounting features."}],"raw_content":"<!--section=description-->\n<h4>Accept Bitcoin payments in your WooCommerce powered WordPress site with BTCPay Server<\/h4>\n\n<p>BTCPay Server for WooCommerce is a revolutionary, self-hosted, open-source payment gateway to accept Bitcoin payments. Our <strong>seamless integration<\/strong> with WooCommerce allows you to connect your self-hosted <a href=\"https:\/\/btcpayserver.org\">BTCPay Server<\/a> and start accepting Bitcoin payments in <strong><a href=\"https:\/\/docs.btcpayserver.org\/WooCommerce\">just a few simple steps<\/a><\/strong>.<\/p>\n\n<h4>Features:<\/h4>\n\n<ul>\n<li><strong>Zero fees<\/strong>: Enjoy a payment gateway with no fees. Yes, really!<\/li>\n<li><strong>Fully automated system<\/strong>: BTCPay takes care of payments, invoice management and refunds automatically.<\/li>\n<li><strong>Display Bitcoin QR code at checkout<\/strong>: Enhance customer experience with an easy and secure payment option.<\/li>\n<li><strong>No middlemen or KYC<\/strong>:\n\n<ul>\n<li>Direct, P2P payments (going directly to your wallet)<\/li>\n<li>Say goodbye to intermediaries and tedious paperwork<\/li>\n<li>Transaction information is only shared between you and your customer<\/li>\n<\/ul><\/li>\n<li><strong>Self-hosted infrastructure<\/strong>: Maintain full control over your payment gateway.<\/li>\n<li><strong>Direct wallet payments<\/strong>: Be your own bank with a self-custodial service.<\/li>\n<li><strong>Lightning Network<\/strong> integrated out of the box - instant, fast and low cost payments and payouts<\/li>\n<li><strong>Reporting and accounting<\/strong> - CSV exports<\/li>\n<li><strong>Advanced invoice management<\/strong> and refunding integrated in the WooCommerce UI<\/li>\n<li><strong>Real-time exchange price tracking<\/strong> for correct payment amounts<\/li>\n<li><strong>Versatile plugin system<\/strong>:\n\n<ul>\n<li>Extend functionality according to your needs<\/li>\n<li>Accept payments in altcoins through various plugins<\/li>\n<\/ul><\/li>\n<li><strong>Elegant checkout design<\/strong>: Compatible with all Bitcoin wallets and enhanced with your store's logo and branding for a unique UX.<\/li>\n<li><strong>Point-of-sale<\/strong> integration - Accept payments in your physical shops<\/li>\n<li><strong>Multilingual ready<\/strong>: Serve a global audience right out of the box.<\/li>\n<li><strong>Top-notch privacy and security<\/strong>: Protect your and your customers' data.<\/li>\n<li><strong>Community-driven support<\/strong>: Get responsive assistance from our dedicated community (<a href=\"http:\/\/chat.btcpayserver.org\">Mattermost<\/a> or <a href=\"https:\/\/t.me\/btcpayserver\">Telegram<\/a>).<\/li>\n<li>Extensive <a href=\"https:\/\/docs.btcpayserver.org\/WooCommerce\">documentation<\/a> and <a href=\"https:\/\/www.youtube.com\/c\/btcpayserver\">video<\/a> tutorials<\/li>\n<\/ul>\n\n<p>The non-profit <a href=\"https:\/\/foundation.btcpayserver.org\">BTCPay Server Foundation <\/a>is committed to keeping this powerful payment gateway free forever. Our mission is to enable anyone to accept bitcoin regardless of financial, technical, social or political barriers.<\/p>\n\n<!--section=installation-->\n<p>This plugin requires WooCommerce. Please make sure you have WooCommerce installed.<\/p>\n\n<p>To integrate BTCPay Server into an existing WooCommerce store, follow the steps below or check our official <a href=\"https:\/\/docs.btcpayserver.org\/WooCommerce\/\">installation instructions<\/a>.<\/p>\n\n<h3>1. Deploy BTCPay Server (optional)<\/h3>\n\n<p>This step is optional, if you already have a BTCPay Server instance setup you can skip to section 2. below. To launch your BTCPay server, you can self-host it, or use a third party host.<\/p>\n\n<h4>1.1 Self-hosted BTCPay<\/h4>\n\n<p>There are various ways to <a href=\"https:\/\/github.com\/btcpayserver\/btcpayserver-doc#deployment\">launch a self-hosted BTCPay<\/a>. If you do not have technical knowledge, use the <a href=\"https:\/\/launchbtcpay.lunanode.com\">web-wizard method<\/a> and follow the video below.<\/p>\n\n<p>https:\/\/www.youtube.com\/watch?v=NjslXYvp8bk<\/p>\n\n<p>For the self-hosted solutions, you will have to wait for your node to sync fully before proceeding to step 3.<\/p>\n\n<h4>1.2 Third-party host<\/h4>\n\n<p>Those who want to test BTCPay out, or are okay with the limitations of a third-party hosting (dependency and privacy, as well as lack of some features) can use a one of many <a href=\"ThirdPartyHosting.md\">third-party hosts<\/a>.<\/p>\n\n<p>The video below shows you how to connect your store to such a host.<\/p>\n\n<p>https:\/\/www.youtube.com\/watch?v=IT2K8It3S3o<\/p>\n\n<h3>2. Install BTCPay WooCommerce Plugin<\/h3>\n\n<p>BTCPay WooCommerce plugin is a bridge between your BTCPay Server (payment processor) and your e-commerce store. No matter if you are using a self-hosted or third-party solution from step 1., the connection process is identical.<\/p>\n\n<p>You can find detailed installation instructions on our <a href=\"https:\/\/docs.btcpayserver.org\/WooCommerce\/\">WooCommerce documentation<\/a>.<\/p>\n\n<p>Here is a quick walk through if you prefer a video:<\/p>\n\n<p>https:\/\/www.youtube.com\/watch?v=ULcocDKZ1Mw<\/p>\n\n<h3>3. Connecting your wallet<\/h3>\n\n<p>No matter if you're using self-hosted or server hosted by a third-party, the process of configuring your wallet is the same.<\/p>\n\n<p>https:\/\/www.youtube.com\/watch?v=xX6LyQej0NQ<\/p>\n\n<h3>4. Testing the checkout<\/h3>\n\n<p>Making a small test-purchase from your own store, will give you a piece of mind. Always make sure that everything is set up correctly before going live. The final video, guides you through the steps of setting a gap limit in your Electrum wallet and testing the checkout process.<\/p>\n\n<p>https:\/\/www.youtube.com\/watch?v=Fi3pYpzGmmo<\/p>\n\n<p>Depending on your business model and store settings, you may want to fine tune <a href=\"https:\/\/docs.btcpayserver.org\/WooCommerce\/#41-global-settings\">your order statuses<\/a>.<\/p>\n\n<!--section=faq-->\n<p>You'll find extensive documentation and answers to many of your questions on <a href=\"https:\/\/docs.btcpayserver.org\/WooCommerce\">BTCPay for WooCommerce V2 docs<\/a> and on <a href=\"https:\/\/docs.btcpayserver.org\/FAQ\/Integrations\/#woocommerce-faq\">BTCPay for WooCommerce integrations FAQ<\/a>.<\/p>\n\n<!--section=changelog-->\n<h4>2.7.5 :: 2026-04-13<\/h4>\n\n<ul>\n<li>Fix: Refunds: remove XMR from payment methods to not break refunds<\/li>\n<li>Fix: Blocks checkout: Improve blocks checkout detection<\/li>\n<li>Fix: Blocks checkout: Allow re-trigger on abort<\/li>\n<li>Fix: Blocks checkout: Ensure customer data form validation can't get skipped<\/li>\n<\/ul>\n\n<h4>2.7.4 :: 2026-03-26<\/h4>\n\n<ul>\n<li>Fix: Make sure modal checkout event handler does not get attached multiple times<\/li>\n<li>Maintenance: Update NodeJS and dependencies to v20<\/li>\n<\/ul>\n\n<h4>2.7.3 :: 2026-03-23<\/h4>\n\n<ul>\n<li>Fix: Add warnings and docs on changing order status mapping of \"paid\" payment status<\/li>\n<li>Fix: Fix deprecation warnings of dynamic properties<\/li>\n<li>Maintenance: Add more debug logging for refunds<\/li>\n<\/ul>\n\n<h4>2.7.2 :: 2025-04-10<\/h4>\n\n<ul>\n<li>Feature: Make icons visible on woocommerce blocks too<\/li>\n<li>Fix: Fix deprecation warnings of dynamic properties<\/li>\n<li>Fix: Formatting in readme.txt<\/li>\n<\/ul>\n\n<h4>2.7.1 :: 2024-11-22<\/h4>\n\n<ul>\n<li>Fix: Update PHP library to v2.8.1 to fix a compatibility issue with refunds on BTCPay 2.0<\/li>\n<\/ul>\n\n<h4>2.7.0 :: 2024-09-04<\/h4>\n\n<ul>\n<li>Feature: Add option to notify customers on refund order notes.<\/li>\n<li>Feature: BTCPay Server 2.0.0 compatibility.<\/li>\n<li>Fix: Make sure to not process orders if the assigned payment gateway is not one of BTCPay.<\/li>\n<li>Fix: Make sure payment methods are set on refunds.<\/li>\n<li>Fix: Wrong currency in refund comment.<\/li>\n<li>Fix: Deprecation warnings.<\/li>\n<li>Maintenance: Update NodeJS dependencies.<\/li>\n<li>Maintenance: Update PHP library to v2.7.0.<\/li>\n<\/ul>\n\n<p>Changelog of older releases can be found <a href=\"https:\/\/github.com\/btcpayserver\/woocommerce-greenfield-plugin\/blob\/master\/changelog.txt\">here<\/a><\/p>","raw_excerpt":"BTCPay Server is a free and open-source bitcoin payment processor which allows you to receive payments in Bitcoin and altcoins directly, with no fees, &hellip;","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/152229","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=152229"}],"author":[{"embeddable":true,"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ndeet"}],"wp:attachment":[{"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=152229"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=152229"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=152229"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=152229"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=152229"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/mr.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=152229"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}