btcpay-greenfield-for-woocommerce
Last commit date
.wordpress-org
4 years ago
assets
2 years ago
languages
4 years ago
src
2 years ago
updates
3 years ago
vendor
2 years ago
btcpay-greenfield-for-woocommerce.php
2 years ago
changelog.txt
2 years ago
license.txt
4 years ago
readme.txt
2 years ago
readme.txt
139 lines
| 1 | === BTCPay for WooCommerce V2 === |
| 2 | Contributors: ndeet, kukks, nicolasdorier |
| 3 | Donate link: https://btcpayserver.org/donate/ |
| 4 | Tags: bitcoin, btcpay, BTCPay Server, btcpayserver, WooCommerce, payment gateway, accept bitcoin, bitcoin plugin, bitcoin payment processor, bitcoin e-commerce, Lightning Network, Litecoin, cryptocurrency |
| 5 | Requires at least: 5.2 |
| 6 | Tested up to: 6.3 |
| 7 | Requires PHP: 7.4 |
| 8 | Stable tag: 2.3.1 |
| 9 | License: MIT |
| 10 | License URI: https://github.com/btcpayserver/woocommerce-greenfield-plugin/blob/master/license.txt |
| 11 | |
| 12 | 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. |
| 13 | |
| 14 | == Description == |
| 15 | |
| 16 | BTCPay Server is a free and open-source cryptocurrency payment processor which allows you to receive payments in Bitcoin and altcoins directly, with no fees, transaction cost or a middleman. |
| 17 | |
| 18 | BTCPay Server is a non-custodial invoicing system which eliminates the involvement of a third-party. Payments with BTCPay WooCommerce Plugin go directly to your wallet, which increases the privacy and security. Your private keys are never uploaded to the server. There is no address re-use since each invoice generates a new address deriving from your xPub key. |
| 19 | |
| 20 | You can run BTCPay as a self-hosted solution on your own server, or use a third-party host. |
| 21 | |
| 22 | The self-hosted solution allows you not only to attach an unlimited number of stores and use the Lightning Network but also become the payment processor for others. |
| 23 | |
| 24 | * Direct, peer-to-peer Bitcoin and altcoin payments |
| 25 | * No transaction fees (other than mining fees by cryptocurrency network itself) |
| 26 | * No processing fees |
| 27 | * No middleman |
| 28 | * No KYC |
| 29 | * User has complete control over private keys |
| 30 | * Enhanced privacy (no address re-use, no IP leaks to third parties) |
| 31 | * Enhanced security |
| 32 | * Self-hosted |
| 33 | * SegWit, Taproot support |
| 34 | * Lightning Network support (LND, c-lightning and Eclair) |
| 35 | * Altcoin support |
| 36 | * Attach unlimited stores, process payments for friends |
| 37 | * Easy-embeddable Payment buttons |
| 38 | * Point of Sale app |
| 39 | |
| 40 | == Installation == |
| 41 | |
| 42 | This plugin requires WooCommerce. Please make sure you have WooCommerce installed. |
| 43 | |
| 44 | <img src="https://github.com/btcpayserver/btcpayserver-doc/blob/master/img/BTCPayWooCommerceInfoggraphic.png" alt="Infographic" /> |
| 45 | |
| 46 | To integrate BTCPay Server into an existing WooCommerce store, follow the steps below or check our official [installation instructions](https://docs.btcpayserver.org/WooCommerce/). |
| 47 | |
| 48 | ### 1. Deploy BTCPay Server (optional) ### |
| 49 | |
| 50 | 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. |
| 51 | |
| 52 | #### 1.1 Self-hosted BTCPay #### |
| 53 | |
| 54 | There are various ways to [launch a self-hosted BTCPay](https://github.com/btcpayserver/btcpayserver-doc#deployment). If you do not have technical knowledge, use the [web-wizard method](https://launchbtcpay.lunanode.com) and follow the video below. |
| 55 | |
| 56 | https://www.youtube.com/watch?v=NjslXYvp8bk |
| 57 | |
| 58 | For the self-hosted solutions, you will have to wait for your node to sync fully before proceeding to step 3. |
| 59 | |
| 60 | #### 1.2 Third-party host #### |
| 61 | |
| 62 | 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 [third-party hosts](ThirdPartyHosting.md). |
| 63 | |
| 64 | The video below shows you how to connect your store to such a host. |
| 65 | |
| 66 | https://www.youtube.com/watch?v=IT2K8It3S3o |
| 67 | |
| 68 | ### 2. Install BTCPay WooCommerce Plugin ### |
| 69 | |
| 70 | 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. |
| 71 | |
| 72 | You can find detailed installation instructions on our [WooCommerce documentation](https://docs.btcpayserver.org/WooCommerce/). |
| 73 | |
| 74 | Here is a quick walk through if you prefer a video: |
| 75 | |
| 76 | https://www.youtube.com/watch?v=ULcocDKZ1Mw |
| 77 | |
| 78 | ### 3. Connecting your wallet ### |
| 79 | |
| 80 | No matter if you're using self-hosted or server hosted by a third-party, the process of configuring your wallet is the same. |
| 81 | |
| 82 | https://www.youtube.com/watch?v=xX6LyQej0NQ |
| 83 | |
| 84 | ### 4. Testing the checkout ### |
| 85 | |
| 86 | 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. |
| 87 | |
| 88 | https://www.youtube.com/watch?v=Fi3pYpzGmmo |
| 89 | |
| 90 | Depending on your business model and store settings, you may want to fine tune [your order statuses](https://docs.btcpayserver.org/WooCommerce/#41-global-settings). |
| 91 | |
| 92 | == Frequently Asked Questions == |
| 93 | |
| 94 | You'll find extensive documentation and answers to many of your questions on [BTCPay for WooCommerce V2 docs](https://docs.btcpayserver.org/WooCommerce) and on [BTCPay for WooCommerce integrations FAQ](https://docs.btcpayserver.org/FAQ/Integrations/#woocommerce-faq). |
| 95 | |
| 96 | == Screenshots == |
| 97 | |
| 98 | 1. The BTCPay Server invoice. Your customers will see this at the checkout. They can pay from their wallet by scanning a QR or copy/pasting it manually into the wallet. |
| 99 | 2. Customizable plugin interface allows store owners to adjust store statuses according to their needs. |
| 100 | 3. Customer will see the pay with Bitcoin button at the checkout.Text can be customized. |
| 101 | 4. Example of successfully paid invoice. |
| 102 | 5. Example of an easy-embeddable HTML donation payment button. |
| 103 | 6. Example of the PoS app you can launch. |
| 104 | |
| 105 | == Changelog == |
| 106 | |
| 107 | = 2.3.1 :: 2023-10-20 = |
| 108 | * Fix: Ensure refunds text does not exceed API field limit. |
| 109 | |
| 110 | = 2.3.0 :: 2023-09-06 = |
| 111 | * Support for high performance order storage (HPOS) |
| 112 | |
| 113 | Note: This is opt-in but brings performance improvements. Follow instructions [here](https://github.com/woocommerce/woocommerce/wiki/High-Performance-Order-Storage-Upgrade-Recipe-Book#how-to-enable-hpos) if you want to use it. |
| 114 | |
| 115 | = 2.2.3 :: 2023-08-22 = |
| 116 | * Automatically create webhook after redirect. |
| 117 | |
| 118 | = 2.2.2 :: 2023-08-22 = |
| 119 | * Fix edgecase JS error on payment method selection. |
| 120 | |
| 121 | = 2.2.1 :: 2023-08-17 = |
| 122 | * Add tooltip with webhook callback information |
| 123 | |
| 124 | = 2.2.0 :: 2023-08-17 = |
| 125 | * Refactor settings UI and allow manual webhook secret entry. This allows 3rd party integrators limit their API keys scope and not include the webhook permission. |
| 126 | |
| 127 | = 2.1.0 :: 2023-04-03 = |
| 128 | * New feature: Modal / Overlay checkout mode (no redirect to BTCPay Server) |
| 129 | |
| 130 | = 2.0.0 :: 2023-03-20 = |
| 131 | * New feature: Add support for refunds. |
| 132 | |
| 133 | Note: If you are upgrading from a version < 2.0 and you want to use refunds (via pull payments) you need to create a new API key with the "Create non-approved pull payments" which is available from BTCPay Server version 1.7.6. |
| 134 | See this link for more information: https://docs.btcpayserver.org/WooCommerce/#create-a-new-api-key |
| 135 | |
| 136 | If you do NOT use refunds. You do NOT need to do anything, your existing API key and setup will continue to work as before. |
| 137 | |
| 138 | Changelog of older releases can be found [here](https://github.com/btcpayserver/woocommerce-greenfield-plugin/blob/master/changelog.txt) |
| 139 |