Why Did My Payment Expire, and What Happens Next?
PreviousDoes Bead support a refund API for crypto, wallet, and BNPL payments?NextWhich consumers can use Klarna, PayPal, and Venmo?
Last updated
A Bead payment expires when the payment quote window closes before any funds are detected. This page explains what causes expiry, what the customer experiences, and how integrators should handle it.
Each Bead payment is backed by a crypto quote — a fixed conversion rate valid for a limited window. The quote window starts when the payment is created. If the customer does not complete the wallet transfer before the quote window closes, the payment moves to expired.
Expiry is triggered by the quote window timing out, not by any action from the merchant or integrator.
When the quote is about to expire, the hosted payment page gives the customer a short window to request a new quote. If the customer does not act within that window, the payment session ends and the status moves to expired automatically.
Any funds that arrive after a payment has expired are not converted. Bead routes those funds to the reclaim flow and returns them to the payer.
If a refundEmail was provided in the original payment request, Bead emails reclaim instructions to that address automatically.
If no email was provided, the hosted payment page prompts the customer to enter an email so reclaim can proceed.
Integrators do not need to implement the return flow directly. See Reclaiming Unconverted Crypto for full details on timing, windows, and customer experience.
Treat expired as a terminal non-success state. Do not fulfill the order.
Do not reuse the expired payment URL. It cannot be restarted.
If the customer still wants to pay, create a new payment and direct them to the new hosted payment URL.
Surface clear messaging so the customer understands what happened and what to do next.
Suggested UI message:
If funds arrived before the quote expired but were not detected in time, or arrived shortly after expiry, they are treated the same as any other post-expiry funds — not converted, and returned through the reclaim process.
The customer should be directed to start a new payment if they still want to complete their purchase.
No. Once a payment reaches expired, the session cannot be resumed or extended. The integrator must create a new payment and provide the customer with the new hosted payment URL.
Last updated
Your payment session expired before a payment was detected. If you sent funds after
the session ended, they will be returned to you through the reclaim process. To try
again, please start a new payment.