> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getruba.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Recover Renewal Revenue
> Follow the retry clock, customer recovery route, and benefit grace period after a renewal fails.
export const RubaSocials = () => {
if (typeof document === "undefined") {
return null;
}
const inject = () => {
const footer = document.getElementById("footer");
if (!footer || document.getElementById("ruba-socials")) {
return false;
}
const isDark = document.querySelector("html.dark") || document.querySelector('html[class*="dark"]');
const lineColor = isDark ? "#383838" : "#e8e8ed";
const iconColor = isDark ? "#8e8e93" : "#86868b";
const markColor = isDark ? "#ffffff" : "#08080c";
const hoverColor = "#0071e3";
const div = document.createElement("div");
div.id = "ruba-socials";
div.style.cssText = `display:flex;align-items:center;gap:20px;padding-top:20px;margin-top:20px;border-top:1px solid ${lineColor};width:100%`;
const logo = `Ruba`;
const spacer = ``;
const ig = ``;
const li = ``;
const x = ``;
const github = ``;
div.innerHTML = logo + spacer + ig + li + x + github;
footer.appendChild(div);
return true;
};
if (!document.documentElement.dataset.rubaSocialsObserver) {
document.documentElement.dataset.rubaSocialsObserver = "true";
const observer = new MutationObserver(() => {
if (!document.getElementById("ruba-socials")) {
inject();
}
});
observer.observe(document.body, {
childList: true,
subtree: true
});
}
setTimeout(() => {
if (!inject()) {
const interval = setInterval(() => {
if (inject()) {
clearInterval(interval);
}
}, 500);
setTimeout(() => clearInterval(interval), 10000);
}
}, 300);
return null;
};
Ruba opens the next billing period before attempting its renewal payment. A declined charge therefore moves the subscription into `past_due` rather than ending it immediately. The open order then moves through payment recovery.
## The retry schedule
The first failure produces three state changes at once:
* `status` becomes `past_due` and `past_due_at` records the failure time;
* the customer receives an email that links to payment-method management in the portal; and
* the order records its next attempt in `next_payment_attempt_at`.
Retries are measured from that first decline:
| Attempt | Wait after the previous attempt | Time since first failure |
| ------- | ------------------------------: | -----------------------: |
| Retry 1 | 2 days | 2 days |
| Retry 2 | 5 days | 7 days |
| Retry 3 | 7 days | 14 days |
| Retry 4 | 7 days | 21 days |
Any successful attempt restores `active`. After the fourth retry, or immediately for a terminal decline such as `lost_card`, recovery stops and the subscription is revoked.
## Benefit revocation grace period
Payment state and access state can move on different clocks. Configure **Settings → Subscriptions → Grace period for benefit revocation** to keep benefits available while the subscription remains `past_due`.
Available delays are **Immediately**, **2 days**, **7 days**, **14 days**, or **21 days**. The delay begins at `past_due_at`; choosing 21 days spans the complete retry schedule.
The setting does not change retry timing and does not make the subscription active. It only postpones benefit removal. Your application can still branch on `status === "past_due"` after receiving [`subscription.updated`](/api-reference/webhooks/subscription.updated).
## Helping customers recover
Replacing the default payment method in the [Customer Portal](/features/customer-portal/introduction) triggers another payment attempt immediately instead of waiting for the scheduled retry.
Your product can support that route by:
* showing a prominent portal link whenever customer state is `past_due`;
* extending the current period through [renewal rescheduling](/features/subscriptions/manage#reschedule-the-next-renewal);
* revoking manually when recovery should stop; or
* issuing a separate [refund](/features/refunds) when money from another order should be returned.