Charge lifecycle

An OpenNode bitcoin payment goes through different statuses during it's lifecycle. Below is an outline of all payment statuses and a diagram that represents all transitions between different statuses.

• unpaid - once a charge is created, it's initial status will be unpaid
• expired - after 24 hours without activity, the charge status will update to expired
• processing - when an on-chain payment is detected but still not confirmed (0 confirmations), the charge status will update to processing
• paid - when a Lightning payment is received and confirmed, or a on-chain payment is received and confirmed (1+ confirmations), the payment status updates to paid, crediting the users account with the received funds
• underpaid - when a on-chain payment is received with an insufficient amount to pay the charge. The user can opt to receive the funds back, or complete the payment by sending the missing BTC amount
• refunded - when an on-chain payment is received but underpaid, and the payer opts to receive their funds back
• failed - when an on-chain payment is received but the transaction is dropped from the mempool before confirming. This typically happens when the fee was too low and the transaction was evicted from the mempool, or when the sender replaced it with a new transaction (RBF)