Payment Rails · Bitcoin Checkout
SovSats
Available · npmCheckout Without Compromise.
A production-grade Bitcoin checkout UI for BTCPay Server. Mobile-first, real-time confirmation, framework agnostic. Settles directly to the merchant wallet. No custodian, no approval process, no third party holding funds.

Specs
Installnpm install sovsats — framework agnostic, 4 env vars
SettlementDirect to merchant-controlled wallet via BTCPay Server
ConfirmationTwo-phase: PROCESSING fires UX redirect, SETTLED fires fulfillment
PollingReal-time 5-second invoice polling, stops on SETTLED or EXPIRED
LightningOn-chain and Lightning Network supported
On-rampCustomer pays card, merchant receives Bitcoin settlement
CustodianNone. Funds never touch a third party.
LicenseMIT — open source
Confirmation handling
The two-phase confirmation split is the part most implementations get wrong. SovSats handles it correctly by default.
| BTCPay Status | SovSats Behavior | Safe For |
|---|---|---|
| NEW | Polling — waiting for mempool | — |
| PROCESSING | Fires onProcessing · UX redirect | UX redirect only |
| SETTLED | Fires onSettled · stops polling | Order fulfillment ✓ |
| EXPIRED | Shows expired state · stops polling | — |
SovereignStack Context
SovSats is a MEF Inc. / SovereignStack product. It ships as an open-source npm package maintained on the SovereignStack release cadence. For merchants who need the full deployment — self-hosted BTCPay Server, Lightning channels, WooCommerce integration, and merchant wallet configuration — that engagement is available through SovereignStack directly.
Related
Need the full BTCPay deployment?
Self-hosted infrastructure, Lightning channels, WooCommerce integration — done and documented.
