Lightning Network

How it works#

Connect your LND node and a Bitcoin Lightning tile appears on checkouts. Choosing it:

1. Checks your node's incoming channel capacity - if there is not enough remote balance to route the payment, the buyer is told immediately instead of paying into a dead invoice
2. Creates a BOLT-11 invoice for the satoshi amount (priced off the on-chain BTC rate)
3. Shows the payment request and QR code; settlement is detected by polling the invoice directly on your node

Settlement is instant: a paid Lightning invoice completes the transaction with zero confirmations - no block wait, no confirmation threshold.

Setup#

1. Open Settings → Nodes & Testnet (requires the wallets permission)
2. Under Bitcoin Lightning Network, set your node URL (e.g. https://lnd.yourdomain.com; port 8080 is assumed if you omit one)
3. Paste your LND macaroon hex (an invoice-creating macaroon is sufficient) - it is stored encrypted
4. Optionally add extra headers (e.g. Grpc-Metadata-macaroon) if your node sits behind a proxy
5. Turn Lightning active on

Running it well#

• Inbound liquidity is the constraint. Keep enough remote balance on your channels for your typical sale size; U.CASH emails you when a payment had to be refused for insufficient remote balance
• HTTPS with a valid certificate is required - the connection to your node verifies TLS
• Lightning runs alongside on-chain BTC; buyers pick their rail from the two tiles
• Fees: Lightning payments settle to your node; you pay only channel costs - there is no platform surcharge for the rail