diff --git a/GrandNodeAcceptBitcoin.png b/GrandNodeAcceptBitcoin.png new file mode 100644 index 0000000..31d8ffb Binary files /dev/null and b/GrandNodeAcceptBitcoin.png differ diff --git a/README.md b/README.md index 0af5cd0..bac2522 100644 --- a/README.md +++ b/README.md @@ -1,42 +1,71 @@ -# BTCPay plugin for GrandNode - accept Bitcoin payments +# BTCPay Server – Accept Bitcoin payments in GrandNode +![BTCPay GrandNode Banner](GrandNodeAcceptBitcoin.png) ## Plugin Overview -This plugin allows you to easily integrate Bitcoin payments into your GrandNode website using BTCPay Server — a free, self-hosted and open-source payment gateway solution designed to revolutionize Bitcoin payments. Our seamless integration with GrandNode ensures a hassle-free connection to your self-hosted BTCPay Server. +This plugin allows you to easily start accepting Bitcoin payments in your GrandNode e-commerce store using BTCPay Server — a free, self-hosted and open-source payment gateway. -Experience the simplicity of accepting Bitcoin payments with just a few straightforward steps. You can configure the plugin either automatically or manually, depending on your preferences and requirements. +## Features -## Automatic Configuration +- 0% Fees: Enjoy a payment gateway with no fees. Yes, really! +- No complicated KYC needed, you're your own, self-hosted payment gateway +- Automated invoice management and refunds +- Simple and customizable checkout UX, available in 30+ languages +- Direct payments to your wallet, no intermediary +- Reporting and accounting – CSV exports +- Real-time exchange price tracking for correct payment amounts +- Community-driven support +- Extensive documentation and video tutorials + +## Getting Started + +### Download and installation + +The plugins can be downloaded through GrandNode Extension Directory or GitHub. + +For installing the plugin on GrandNode, you can either upload the plugin directly to the `/plugins` folder in your GrandNode main directory and restart your application, or use the Admin Panel to upload the plugin. + +In the **Admin Panel**, navigate to **Plugins -> Local Plugins** and click the **"Upload"** button. Ensure the plugin file is in ZIP for successful upload. After uploading, find the plugin in the list, click "Install" next to it, and enable it if needed​. + +## Plugin configuration + +You can configure the plugin either automatically or manually, depending on your preferences and requirements. + +### Automatic Configuration 1. Enter Url to your BTCPay Server into "BTCPay Url" field. (e.g. https://mainnet.demo.btcpayserver.org) -2. Click on the "Configure automatically" button to be redirected to the API authorization page on your BTCPay server -3. On BTCPay authorization page: Select the store you want to connect to your GrandNode (you might need to login first) +2. Click on the "Configure automatically" button to be redirected to the API authorization page of your BTCPay Server +3. On the authorization page: Select the store you want to connect to your GrandNode (you might need to login first) 4. Click on "Authorize App" button and you will be redirected back to your GrandNode 3. The "API Key", "BTCPay Store ID" and "Webhook Secret" fields will be automatically filled and a webhook created -4. Click "Save" button at the top right to persist the configuration +4. Click "Save" button at bottom to persist the configuration 5. Congrats, the configuration is now done. - Note: given the architecture of GrandNode, it is possible that malfunctions in redirections may occur. Particularly if https is disabled or incorrectly configured. In this case, please opt for manual configuration. -## Manual Configuration +### Manual Configuration Ensure that the following fields are filled out: "BTCPay Url," "API Key," "BTCPay Store ID," and "WebHook Secret." -To create the BTCPay API key, [read this](https://docs.btcpayserver.org/VirtueMart/#22-create-an-api-key-and-configure-permissions). +To create the **BTCPay API key**, [read this](https://docs.btcpayserver.org/VirtueMart/#22-create-an-api-key-and-configure-permissions). - Note: If you want to use the Refund feature, you must also add the "Create non-approved pull payments" permission. After a refund, an order note is created where you can copy the pull payments link and send to your customer (this order note is also visible by the customer). The customer can request the refund on that page. -To create the BTCPay WebHook, [read this](https://docs.btcpayserver.org/VirtueMart/#23-create-a-webhook-on-btcpay-server) and use the default secret code generated by BTCPay. +To create the **BTCPay WebHook**, [read this](https://docs.btcpayserver.org/VirtueMart/#23-create-a-webhook-on-btcpay-server) and use the default secret code generated by BTCPay. - Note: Other than in the guide you need to copy the Url shown in field "Webhook Url" from your configuration screen on GrandNode. +BTCPay **Store ID** can be obtained from your BTCPay Server, in Store Settings > General > Store ID field. + ## Support -Feel free to join our support channel over at [Mattermost Chat](https://chat.btcpayserver.org/) if you need help or have any further questions. +Feel free to join our support channel over at [Mattermost](https://chat.btcpayserver.org/) or [Telegram](https://t.me/btcpayserver) if you need help or have any further questions. + +If experience a bug please [open a bug report](https://github.com/btcpayserver/btcpay-grandnode-plugin/issues) -If experience a bug please open an issue in our repository [here] ## License This plugin is released under the [MIT License](LICENSE). ---- -Find our latest releases on our [release page] +The non-profit [BTCPay Server Foundation](https://btcpayserver.org) is committed to keeping this powerful payment plugin free forever. Our mission is to enable anyone to accept bitcoin regardless of financial, technical, social or political barriers. + +--- \ No newline at end of file