You can move funds from the BitBoxApp Lightning wallet to one of your on-chain BitBox Bitcoin accounts. Choose a normal withdrawal to keep using the Lightning wallet, or Close and Withdraw Funds to withdraw its complete remaining balance and close it.

Both paths involve a fee and depend on the integrated Spark infrastructure. After the withdrawal is broadcast, it also needs confirmation on the Bitcoin blockchain.

Choose the correct path

What you want to do Use
Move some funds to Bitcoin and keep this Lightning wallet A normal on-chain withdrawal
Move the complete remaining balance to Bitcoin and end this Lightning wallet Close and Withdraw Funds
Stop using the wallet temporarily without moving its balance Disable the Lightning wallet

Withdraw and keep the Lightning wallet

  1. Open Lightning in the BitBoxApp.
  2. Select Send.
  3. Select Enter address or invoice, then Select an account.
  4. Select the BitBox Bitcoin account that should receive the funds. The app uses that account's next unused address.
  5. Select Continue.
  6. Enter at least 294 satoshis (sats).
  7. Review the destination account, amount, Bitcoin network fee, and total deduction.
  8. Select Send only when every detail is correct.

If the destination wallet is remembered in the BitBoxApp, you do not need to connect the BitBox. Otherwise, connect and unlock it so the app can display its accounts. The BitBox does not sign this withdrawal because the funds are spent from the Lightning hot wallet.

Withdrawal created

The Lightning part is complete when the BitBoxApp shows the withdrawal as sent. The resulting transaction then appears in the receiving Bitcoin account. Wait for the required Bitcoin confirmations before treating the on-chain transfer as final.

 

Close the wallet and withdraw all funds

Closing is permanent. It sends the remaining balance to Bitcoin and ends this Lightning wallet. A closed wallet cannot be restored; enabling Lightning again later creates a new Lightning wallet.

Stop receiving before closing

Do not close the wallet while you are expecting an incoming payment. Wait for expected payments to complete, then stop sharing its invoices and Lightning address before you continue.

 
  1. Confirm that no expected incoming payment is still pending.
  2. Open Settings.
  3. Open Advanced Settings.
  4. Select Lightning Settings.
  5. Select Close and Withdraw Funds.
  6. Select the BitBox Bitcoin account that should receive the remaining balance.
  7. Review the destination account, amount, fee, and closure warning.
  8. Select the checkbox confirming that you want to close the Lightning wallet.
  9. Select Close and Withdraw Funds.
  10. Wait until the BitBoxApp confirms both the withdrawal and wallet closure.

Wallet closed

Closure is complete in the app when the BitBoxApp confirms that the remaining funds were withdrawn and the Lightning wallet is closed. The resulting Bitcoin transaction is complete on-chain only after it receives the required confirmations in the destination account.

 

Understand the dependency on Spark

The BitBoxApp shows the applicable fee before confirmation. The amount available after fees may be lower than the displayed Lightning balance.

The current BitBoxApp does not support a unilateral exit. Withdrawing or closing therefore depends on Spark being online and cooperative. Your BitBox backup can recreate the wallet keys, but it cannot by itself force an exit during a Spark outage.

If the withdrawal does not complete

  • The destination account is not listed: connect and unlock the relevant BitBox if its wallet is not remembered in the BitBoxApp.
  • The amount is below 294 sats: increase it to at least the stated minimum.
  • The balance does not cover the amount and fee: lower the amount or add sufficient Lightning balance.
  • Incoming funds are pending: wait for them to complete before closing.
  • Spark is unavailable: keep the wallet enabled and try again after service is restored.
  • The withdrawal remains pending: check its transaction status before creating another attempt.

Contact BitBox Support

Contact BitBox Support if the withdrawal remains unavailable or fails repeatedly. Include the BitBoxApp version, mobile operating system, approximate time, amount, destination account type, transaction status, and exact non-sensitive error message.

Never send recovery words, backup contents, an optional passphrase, private keys, passwords, or PINs.