Payment Rails · Bitcoin Checkout

SovSats

Available · npm

Checkout 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 StatusSovSats BehaviorSafe For
NEWPolling — waiting for mempool
PROCESSINGFires onProcessing · UX redirectUX redirect only
SETTLEDFires onSettled · stops pollingOrder fulfillment ✓
EXPIREDShows 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.

Need the full BTCPay deployment?
Self-hosted infrastructure, Lightning channels, WooCommerce integration — done and documented.
Talk to SovereignStack →