Past-due payments and recovery
What happens when a payment fails, the 7-day grace window, and how to recover
If Stripe can't charge your card on the 1st, your account moves to past due. Nothing breaks straight away. You get a 7-day window to fix the payment method, and the workspace keeps running while Stripe retries the card.
What happens on a failed payment
When the invoice.payment_failed event arrives from Stripe, your account's billing_status changes to past_due and the date is recorded as billing_status_changed_at. Stripe starts its retry schedule on the card automatically; you don't need to trigger anything.
Account admins receive a transactional email the first time this happens, with a link back to Settings, Plan & Billing.
The 7-day grace window
During the 7 days after billing_status_changed_at, your account behaves as if it were still active:
- All companies, locations, employees, and content stay editable.
- Integrations stay connected.
- A banner appears across the dashboard explaining the failed payment and showing the date by which it needs to be resolved.
This window exists so a temporary card issue (expired card, fraud lock, daily limit) doesn't immediately disrupt your team. Stripe will keep retrying during this period, and most failures recover on their own once you update the card.
After the grace window
If the invoice is still unpaid 7 days after the status change, optional features go read-only. That means:
- Jobs, references, posts, and gallery (the optional content objects) can still be viewed but not edited or created.
- Integration-driven publishing stops.
- Core company, location, and employee data stays viewable so you can still run the day-to-day.
Settings, Plan & Billing remains fully reachable so you can fix the payment. The same read-only state applies if Stripe escalates the subscription to unpaid or canceled.
How to recover
- Open Settings, Plan & Billing and click Manage billing.
- In the Stripe customer portal, update or replace the payment method.
- Stripe re-attempts the open invoice. If that succeeds, the next webhook (
invoice.payment_succeeded) reactivates the account.
You don't need to click anything in Gridwork after the payment goes through. The webhook flips billing_status back to active, the banner disappears, and optional features become writable again.
A recovery confirmation email is sent to account admins once the invoice is paid.
Frequently asked
How long do I have before things go read-only? 7 days from the moment Stripe first marks the invoice as failed.
Will I lose data during read-only mode? No. Everything is preserved. You just can't edit optional content until the payment clears.
Can I pay an invoice manually? Yes. The Stripe customer portal lists open invoices with a Pay now button next to each one.
Still need help? Contact support