See It in Action
Screenshots from a running instance.
Dashboard
Checkout
Setup Wizard
Payment gateways want your ID and your customers' ID — so fewer people bother paying. BTCPay Server needs a VPS, Docker expertise, and $20+/month. CashuPayServer is the middle ground: a BTCPay-compatible gateway that runs on the PHP hosting you probably already have.
Every option has costs. Here's where CashuPayServer fits.
Convenient, but you hand over control.
Full sovereignty, but needs sysadmin skills.
Upload to shared hosting and you're done.
Built for merchants who want to accept Bitcoin without running infrastructure.
Read every line of code. Fork it, audit it yourself. No black boxes.
No account creation at any mint. Your store talks to the mint's public API directly, same as any other client.
Customers see a normal Lightning invoice — no need to know about Cashu. Merchants don't need to either: auto-withdrawal to a Lightning address means sats go straight to your wallet.
Works on the cheapest shared PHP hosting you can find. If it runs WordPress, it runs this.
Implements BTCPay Server's Greenfield API. WooCommerce and other plugins connect by changing one URL.
Started with CashuPayServer and later set up BTCPay? Just update the URL and API keys in your e-commerce plugin. Nothing else changes.
No terminal. No config files. Just a web browser.
Download the zip, extract it, upload to your web hosting via FTP or file manager. That's the "install."
Open the URL in your browser. The setup wizard walks you through picking a Cashu mint and setting a password.
In your WooCommerce (or other) BTCPay plugin settings, paste your CashuPayServer URL instead of a BTCPay Server URL. Done.
Screenshots from a running instance.
Dashboard
Checkout
Setup Wizard
CashuPayServer works with any Cashu mint, including third-party ones. But third-party mints hold your funds until you withdraw them. They could disappear. If you're serious about sovereignty, run your own mint. It's the Bitcoin way. Third-party mints are fine for testing or small amounts you're willing to lose.
Build on top of CashuPayServer or use the components standalone.
Standalone PHP library for Cashu. Mint tokens, manage proofs, interact with NUT-compliant mints. MIT licensed.
require 'CashuWallet.php';
$w = new Wallet($mintUrl);
$w->loadMint();
BTCPay's v1 API. Create invoices, register webhooks, check status. Your existing BTCPay integration code works as-is.
POST /api/v1/stores/{id}/invoices
GET /api/v1/stores/{id}/invoices/{id}
POST /api/v1/stores/{id}/webhooks
PHP 8.0+ with curl, json, and sqlite3 extensions. That's it. Works on Apache, nginx, LiteSpeed, or anything else that serves PHP.
PHP 8.0+
ext-curl
ext-json
ext-sqlite3
CashuPayServer is free and open source. Donations help keep it that way — and this is a live demo of the payment flow. Yes, we use CashuPayServer to accept donations.
The project is free and open source and you run it on your own infrastructure. There is voluntary donation to support the project when you withdraw money through the Cashu mint. We do not process or have custody of your Bitcoin at any time.
This project is primarily focused on Bitcoin Lightning. Some mints might support other tokens to store the received money (for example USD or EUR), but this is not very well tested. And customers pay with Bitcoin over Lightning in any case. Withdrawal is possible to Lightning (through the mint's melt function) and directly using Cashu protocol to your Cashu wallet.
Yes it is. Seriously. We love it, we use it. But for some shops, when they are just starting to accept Bitcoin, it might be an overkill to install and maintain. CashuPayServer runs on the infrastructure you probably already have and that's its advantage. When you "grow up", we hope you switch to BTCPayServer. We've done everything in as compatible a way as possible, so the switch is easy. It will be better user experience for your customers as well — invoices are created faster, etc. BTCPayServer also has a lot more features — PoS, crowdfunding module, refunds, ...
It is unfortunately your responsibility to consider all the legal aspects. You are running the gateway. We believe this is legal to run in most jurisdictions. But we also are not lawyers. For this, do your own research, consult a good tax, etc. attorney.
We also believe accepting Bitcoin for your own business does not make you a licensed provider in most jurisdictions — you are essentially running your own gateway. KYC is required for payment gateways that provide this service to third parties. But also — you need to consult lawyers yourselves, we are not lawyers and we don't know which country you are from.
No, we are a new project. Test it out with small purchases and let us know!
No. You are. This is open-source software without any warranty whatsoever. You should setup auto-withdraw though.