About these signals: Optaimaze currently measures historical candidate rankings, not payment success probability or independent node reliability. Read methodology and coverage →

← Why Lightning payments fail

Lightning error guide

"Payment timed out": what Lightning timeouts and stuck payments really mean

Last updated:

A Lightning payment that "timed out" can mean two very different things, and mixing them up is how people end up paying twice. LND reports FAILURE_REASON_TIMEOUT ("payment attempts exceeded timeout"). Core Lightning stops retrying when its retry_for window runs out. Wallets usually show "payment timed out" or leave the payment marked as pending.

The key question is whether any part of the payment is still in flight. A timeout that ended cleanly with nothing pending is just a failed payment. A payment whose HTLC is still locked somewhere along the route has not failed yet, even if the app says it timed out.

Live data

Live Lightning routing signal

Reliability signal100/100
SignalStrong historical signal
Risk levelLow
Top-ranked nodeACINQ
Last snapshotNov 22, 2026 20:56 UTC

This is a historical ranking proxy built from observed route candidates over the last 24 hours. It is not a payment success probability and does not measure directional liquidity for your specific path.

Check current routing reliability on the dashboard →

Two kinds of timeout

1. Pathfinding ran out of time

When you pay, your node tries a route, learns from any failure, and tries again. It keeps going until it succeeds, runs out of candidate routes, or hits a time limit. LND's lncli payinvoice defaults to a 60-second --timeout, and applications using the router API set timeout_seconds themselves. If the limit arrives first, the node stops launching new attempts and reports a timeout. If no attempt is still pending, the payment has definitively failed, nothing was spent, and you can retry.

2. An HTLC is stuck in flight

Each attempt locks funds in an HTLC at every hop. Usually it settles or fails within seconds. But if a node on the path goes offline, or a recipient deliberately holds the payment (for example with a hold invoice), the HTLC stays locked until it settles or its time-lock (CLTV) expires. That can take minutes to hours, and in rare cases longer. During that window the payment is neither complete nor failed. Your node shows it as in flight or pending even after the app has given up waiting.

Common causes

What senders should do

  1. Check the payment status before retrying. In LND, use lncli trackpayment <payment_hash> or listpayments. In Core Lightning, use listpays or listsendpays. Look for any attempt still marked in flight or pending.
  2. If nothing is in flight, the payment failed. Retry the same invoice if it has not expired, ideally after a short wait.
  3. If something is in flight, wait. Do not ask the recipient for a new invoice and pay that too. If the original HTLC later settles, you will have paid twice. Paying the same invoice again is generally protected by the shared payment hash, and most node software refuses to start a second payment for a hash that is still pending.
  4. Keep your node or wallet online until the payment resolves, so it can process the settlement or failure.

What developers and node operators can do

Timeouts and route stability

Timeouts tend to cluster when routing conditions are unstable and the best candidates keep changing. The Optaimaze insights dashboard tracks leadership changes and volatility among observed route candidates over time. It is a historical ranking signal that can add context when you investigate a spike in timeouts, not a prediction for any single payment.

Error guides

Lightning payment error guides

FAQ

Payment timeout FAQ

What does "payment timed out" mean on Lightning?

Usually it means your node stopped trying new routes because a time limit was reached. If no attempt is still in flight, the payment failed and nothing was spent. If an HTLC is still pending somewhere on the route, the payment is unresolved and could still succeed or fail.

Is it safe to retry a timed-out Lightning payment?

Check the payment status first. If nothing is in flight, retrying the same invoice is fine. If an attempt is still pending, wait. Never pay a new invoice for the same purchase while the first payment is in flight, or you may pay twice.

How long can a Lightning payment stay pending?

Most payments resolve in seconds. A stuck HTLC stays locked until it settles or its time-lock expires, which can take minutes to hours and in rare cases longer, depending on the CLTV deltas along the route.

Why do Lightning payments time out more often over Tor or on mobile?

Each payment attempt involves several network round trips. Tor latency and unstable mobile connections slow every attempt, so fewer attempts fit inside the timeout, and a suspended app may stop processing updates.

How can developers reduce Lightning payment timeouts?

Set timeouts that fit the use case, treat pending as a distinct state, key payment records by payment hash to avoid double charges, peer with high-uptime nodes, and monitor pending HTLC counts and ages.

Live reliability signal

Check current routing reliability.

See current top-ranked route candidates, leadership changes, volatility, and risk level from recent snapshots.

Open Insights