BTCPay
Принимайте Bitcoin-платежи через BTCPay
Support the Payment-BitcoinPayServer Provider – Power the Future of Medusa Commerce!
Dear Developers and E-commerce Pioneers,
Get ready to embrace the world of decentralized finance for your online stores with MedusaJS! We are excited to introduce the Payment-BitcoinPayServer provider – a community-driven project that brings the powerful Bitcoin PayServer gateway to our MedusaJS commerce stack.
What's in it for You:
🛡️ Secure & Sovereign Payments: Enable direct Bitcoin Network payments without relying on third-party payment processors.
🌍 Borderless Transactions: Serve a global audience with permissionless payments that know no borders.
🚀 Empower Open Commerce: By sponsoring this provider, you contribute to the Medusa community's growth, independence, and innovation!
Installation Made Simple
Use the package manager npm to install Payment-BitcoinPayServer.
Usage
Set up a Bitcoin PayServer instance, either self-hosted or via a trusted host.
In your environment file () define:
You need to add the provider into your :
Client Side Configuration
For your Medusa Next.js storefront, follow these steps:
Step 1. Install the Bitcoin Payment Button package
(optional - depends on your design)
Step 2. Create the Bitcoin Payment Button Component in packages/storefront/src/modules/checkout/components/payment-button/index.tsx
Step 2.1 introduce a state variable to track clicks.
Step 2.2 Then in the case
Step 3. Extend Payment Constants
In :
Step 4. Hook Up the Payment Button
In :
step 5 . Create a confirmation page to poll the server --
You can use any mechanism, but i'chosen long polling, coz its just simple. You could use websockets or any other call back mechanism.
processing/page.tsx
Step 6. Configure Environment Variables in Frontend
Set the following environment variables for your storefront:
Setting Up BTCPay Server Webhook
In BTCPayServer, add a webhook with this URL:
<your-host-url>/hooks/payment/btcpay_btcpayMake sure you set the webhook secret to match your value.
Contributing
Pull requests are welcome! For significant changes, please open an issue first to discuss improvements or new features.
Please ensure tests and documentation are updated appropriately.
License
Untested Features
Some features exist but haven't been fully tested in client integration:
- Refund support
- Lightning Network (LNURL and other advanced flows)
Disclaimer
This project is community-driven and tested in limited scenarios. Bugs may occur; please raise issues or submit pull requests if you encounter any.
Support the Payment-BitcoinPayServer Provider – Fuel Open Commerce!
Dear Medusa Enthusiasts,
Thank you for your passion and energy for open e-commerce!
The Payment-BitcoinPayServer provider is an open-source project crafted to connect MedusaJS with the powerful Bitcoin payment ecosystem.
If you find this project useful, consider sponsoring it on GitHub to help maintain and expand it.
Your support makes a world of difference in creating decentralized, open, and innovative commerce for all.
Let's keep building the future together!
With gratitude,
SGFGOV
Lead Developer, Payment-BitcoinPayServer Provider

