FeaturesDepositClearUpdated March 13, 2026
Payment Failure Notifications
Payment Failure Notifications
Available from: v0.1.251
When a Stripe payment for your subscription fails, the platform now automatically alerts all organisation owners and admins so you can act before your account is suspended.
What Triggers a Notification
A notification is sent whenever Stripe fires an invoice.payment_failed event against your organisation's subscription. Common causes include:
- Expired or cancelled card
- Insufficient funds
- Card issuer decline
- 3D Secure authentication not completed
What Happens When a Payment Fails
- Subscription status update — The subscription row is immediately set to
past_duein the platform database. - Email alert — An email is dispatched to every owner and admin on the organisation, warning that the subscription is at risk and providing a direct link to the billing page.
- In-app notification — A notification is inserted for all org admins containing a link to
/dashboard/billing. - Dashboard banner — An optional banner may be surfaced on the main dashboard at next login, ensuring the failure is visible even if email is missed.
Who Receives Notifications
Notifications are sent to all users holding an owner or admin role within the organisation. Standard members do not receive billing alerts.
Resolving a Payment Failure
- Click the link in the email or in-app notification, or navigate to Dashboard → Billing (
/dashboard/billing). - Update your payment method or resolve the issue with your card provider.
- Use the Retry payment option on the billing page (or wait for Stripe's automatic retry cycle).
Once payment succeeds, Stripe will fire invoice.payment_succeeded and the subscription status will return to active.
Technical Notes
| Component | Detail |
|---|---|
| Webhook handler | src/app/api/webhooks/stripe/route.ts |
| Event bus | Inngest (event fired after past_due status write) |
| Email infrastructure | Existing sendEmail utility |
| Notification target | All org owners and admins |
| Billing page deep-link | /dashboard/billing |