This plugin adds BTCPay Server as a payment gateway inside FluentCart. At checkout the customer\nis redirected to your BTCPay Server's hosted invoice page, pays with Bitcoin on-chain or over\nLightning, and is redirected back to your store. BTCPay notifies your store through a webhook\nand the FluentCart order is marked paid.<\/p>\n\n
You run the payment infrastructure yourself. There is no account to open with us, no middleman\nholding your funds, and no percentage fee - the plugin talks only to the BTCPay Server instance\nwhose address you enter in the settings.<\/p>\n\n
Features<\/strong><\/p>\n\n Requirements<\/strong><\/p>\n\n This plugin connects to one external service: the BTCPay Server instance that you configure\nyourself<\/strong> in the plugin settings. No connection is made until you enter a host, Store ID and API\nkey. The plugin does not contact BTCPay Server's own servers, our servers, or any other\nthird-party service.<\/p>\n\n What is sent, and when<\/strong><\/p>\n\n No customer personal data (name, email, address) is sent to BTCPay Server by this plugin, and no\ndata is sent anywhere else.<\/p>\n\n Because the BTCPay Server instance is one you choose and operate, the applicable terms and\nprivacy policy are those of that instance and its host. BTCPay Server is free and open-source\nsoftware; its project terms and documentation are available at:<\/p>\n\n FluentCart is only told about completed payments through a BTCPay webhook. Without it, orders\nwill stay pending even after the customer pays.<\/p>\n\n Set the Payload URL to:<\/p>\n\n https:\/\/YOUR-SITE.com\/?fluent-cart=fct_payment_listener_ipn&method=btcpay<\/p>\n\n (The exact URL for your site is shown on the plugin's settings screen.)<\/p><\/li>\n The plugin acts on No. The plugin connects only to the BTCPay Server instance you configure. There is no\nregistration, no API of ours involved, and no fee taken from your payments.<\/p><\/dd>\n You need a BTCPay Server instance you control. That can be one you self-host or one on a\nthird-party BTCPay host. The plugin does not provide one.<\/p><\/dd>\n No. BTCPay Server does not support recurring crypto billing, so subscriptions are permanently\nout of scope for this gateway.<\/p><\/dd>\n Not yet. Note that BTCPay refunds work differently from card processors: they generate a claim\nlink the customer uses to pull the funds, rather than pushing money back automatically. You can\nissue refunds manually from the BTCPay Server invoice screen.<\/p><\/dd>\n No built-in sandbox toggle - test against a separate shop\/BTCPay store (e.g. one on testnet or\nregtest) instead.<\/p><\/dd>\n Your Greenfield API key is sent as an authorization header on every request. Over plain http it\nwould travel in the clear, so the settings screen rejects non-https hosts.<\/p><\/dd>\n Almost always a webhook problem. Check that the webhook exists in BTCPay, that its Payload URL\nmatches the one shown on the plugin settings screen, and that the Webhook Secret saved in\nWordPress matches the one BTCPay generated. BTCPay's webhook screen shows recent delivery\nattempts and their responses.<\/p><\/dd>\n\n<\/dl>\n\n\n\n
BTCPay-Sig<\/code>)<\/li>\n\n
External services<\/h3>\n\n
\n
\n
\n
btcpay.store.cancreateinvoice<\/code>) and\n\"View invoices\" (btcpay.store.canviewinvoices<\/code>) permissions for your store.<\/li>\n\n
https:\/\/btcpay.example.com<\/code><\/li>\nWebhook setup (required)<\/h4>\n\n
\n
InvoiceSettled<\/code> (order marked paid) and InvoiceExpired<\/code> \/ InvoiceInvalid<\/code>\n(transaction marked failed if it wasn't already paid). All other events are acknowledged and ignored.<\/p>\n\n\n\n
Do I need an account with you to use this?<\/h3><\/dt>\n
Do I need to run my own BTCPay Server?<\/h3><\/dt>\n
Does this support subscriptions?<\/h3><\/dt>\n
Does this support refunds from the FluentCart admin?<\/h3><\/dt>\n
Is there a test mode?<\/h3><\/dt>\n
Why must the BTCPay host be https?<\/h3><\/dt>\n
My orders stay pending after the customer pays. What's wrong?<\/h3><\/dt>\n
0.1.0<\/h4>\n\n
\n