How to Receive Lightning Payments in BlueWallet Using a Lightning Invoice?

Understanding Lightning Invoices

1. A Lightning invoice is a QR code or alphanumeric string generated by a recipient to request a specific amount in satoshis.

2. It contains critical routing metadata including the payment hash, expiry time, description, and destination node’s public key.

3. Unlike on-chain Bitcoin addresses, Lightning invoices are single-use and time-bound—most expire after 15 minutes unless configured otherwise.

4. BlueWallet validates invoices client-side before broadcasting them across the Lightning Network, ensuring compatibility with LND, Core Lightning, and Eclair backends.

5. The invoice format follows BOLT-11 specification, which mandates strict base32 encoding and checksum integrity checks.

Setting Up Your BlueWallet Lightning Wallet

1. Install BlueWallet from official app stores—avoid third-party APKs or IPA files that may lack signature verification.

2. During wallet creation, select “Lightning Wallet” instead of “Bitcoin Wallet” to initialize a dedicated LND backend instance.

3. Confirm your node is synced by checking the status indicator next to the “Receive” button—it must show “Online” and display channel balance.

4. Ensure at least one active inbound channel exists; otherwise, incoming payments will fail even if the invoice is valid.

5. Disable battery optimization for BlueWallet on Android to prevent background LND process termination during payment confirmation.

Generating and Sharing a Receive Invoice

1. Tap the “Receive” tab inside your Lightning wallet view.

2. Enter the exact amount in sats or BTC—BlueWallet auto-converts based on current exchange rate cache.

3. Add an optional memo up to 64 UTF-8 characters; this appears in the sender’s transaction note but does not affect routing.

4. Press “Create Invoice” to generate a BOLT-11 string and corresponding QR code.

5. Share the QR code via chat, email, or NFC—never paste the raw invoice into untrusted web forms or phishing sites.

Verifying Payment Confirmation

1. Once the sender initiates payment, BlueWallet displays a pending status with animated lightning icon.

2. Final confirmation occurs only after HTLC settlement and preimage revelation—this typically completes within 1–3 seconds under normal network conditions.

3. Check the transaction history: successful entries show green “Received” label, timestamp, and decoded memo.

4. If the invoice expires before settlement, BlueWallet marks it as “Expired” and disables further attempts without manual regeneration.

5. Do not assume success upon QR scan—the sender’s wallet must fully commit the payment through the route.

Frequently Asked Questions

Q: Can I reuse a Lightning invoice after it’s been paid?No. Each BOLT-11 invoice binds to a unique payment hash. Reuse triggers rejection by all compliant Lightning nodes.

Q: Why does my BlueWallet show “No inbound liquidity” when trying to receive?This means your node has no open channels accepting incoming payments. You need at least one channel funded by another party or opened with inbound capacity enabled.

Q: Is it safe to share my Lightning invoice publicly on social media?Yes—but only if the invoice is freshly generated and intended for immediate use. Public exposure of expired or unpaid invoices poses no risk, as they cannot be double-spent or altered.

Q: What happens if the sender’s node goes offline mid-payment?The HTLC remains locked until timeout. BlueWallet automatically releases the hold after the invoice’s cltv_expiry block height passes, returning funds to the sender’s wallet.