Payment recovery

When a renewal fails, the subscription enters past_due (or unpaid). Rollo supports automatic retries on failed renewals plus merchant-triggered recovery from the dashboard.

Lifecycle

  1. Renewal charge fails → invoice.payment_failed webhook and subscription status past_due.
  2. Automatic retries continue according to recovery settings. Track attempts on the subscription.
  3. Merchant may click Retry payment or resume collection if billing was paused.
  4. Success → invoice.paid and status returns to active.

Pause during recovery

Pausing with void outstanding stops further collection attempts on past-due invoices. Use this when you have resolved the issue offline or granted access manually.

Customer action required

Some failures need a new payment method or SCA confirmation. Subscribe to invoice.payment_action_required and send the customer back through Checkout or a billing portal flow you host.

API

POST /v1/subscriptions/sub_.../retry_payment
Authorization: Bearer rk_live_...

{
  "attempts": 2,
  "status": "past_due"
}