payment-failure-handler

Automate Stripe payment failure recovery by configuring webhooks to detect failed invoices and trigger a workflow that updates membership status, schedules retries, and sends alerts. This handler manages the entire process, enforcing a grace period with up to three retries while notifying members and admins.

Yes, you need Twilio and Supabase to handle Stripe webhook payment failures with this handler. The workflow requires Supabase to update and track membership status, and Twilio to deliver automated notifications to members and admins regarding retry schedules and escalation.

During a failed payment retry grace period, the member's access is preserved while the system attempts recovery. This handler schedules up to three automated retries across the grace period, ensuring members retain their access until all recovery attempts are exhausted.

Set up Stripe webhooks for failed invoice payments by configuring your Stripe dashboard to send events like invoice.payment_failed to your handler endpoint. Once deployed, the handler automatically detects these events, updates membership status, and schedules the retry workflow.

The number of payment retries for failed Stripe memberships is fixed at a maximum of three attempts. This handler enforces this limit across a defined grace period, automatically escalating notifications to admins and members if recovery fails after the final attempt.