Job flow 3 · task:retry-payment Diagram

Queued by: PaymentEventProcessor.handlePaymentFailed for a renewal (cycle ≥ 1) when the failure reason is temporary — Stripe insufficient_funds, processing_error, issuer_not_available, try_again_later and similar; Razorpay insufficient_funds, bank/gateway/issuer technical errors, payment_timed_out and similar — and it is not a Razorpay mandate-limit breach. Failed attempt 0 (the renewal) → attempt 1, 1 → 2, 2 → 3. A manual 'Retry Now' failure queues nothing.
Job ID retry-payment-<sub>-cycle<n>-attempt<k>, delay 3 days, attempts 1. Completed jobs are kept so a redelivered failure webhook cannot add the same attempt twice.
Still PAST_DUE: status must be PAST_DUE, cycle unchanged, provider, card and locked price present. Paid in the meantime, expired, or token revoked → nothing happens.
Amount = pushed or locked price − running discount, the same as the original renewal. ≤ 0 (a discount added since) → internal settlement, chain ends.
Lock held (a manual retry in flight) → job moved back to delayed for 15 minutes and runs again; if the other charge settles the cycle, the PAST_DUE check then skips it.
Paid → webhook: ACTIVE, new period starts at the payment date (late payment), cycle + 1, grace and retry jobs removed, 'Payment Successful' + PDF. Declined → PAYMENT_FAILED event: no email, no new grace; the next attempt only for a temporary reason, at most 3. Monthly grace is 7 days, so attempt 3 (day 9) never runs for monthly plans.