changelog/payment-failure-recoveryshipped apr 14, 2026
A declined card should not be the end of a sale. Now you route each decline reason to the right recovery: a recapture page, a downsell, or an on-session retry, all with a one-line map instead of hand-wired error handling.
Use cases
- Recapture the fixable - send an expired-card decline to a page that asks for a new one
- Downsell the hesitant - route an insufficient-funds decline to a cheaper offer
- Retry the transient - re-attempt a soft decline on-session without losing the buyer
Impact
Failed payments stop being lost payments. Because the whole recovery flow is a short, declarative map, you can see every decline path at a glance and change it without touching fragile error code.