Stripe webhook event
payment_method.attached
A payment method was attached to a customer.
Quick answer
A customer adds or updates a card, often via your card update page.
| Event type | payment_method.attached |
|---|---|
| Category | Customers & payment methods |
| When it fires | A customer adds or updates a card, often via your card update page. |
| Recovery-relevant? | Yes, used in failed-payment recovery |
When it fires
A customer adds or updates a card, often via your card update page.
What to do with it
Retry any open or past_due invoices immediately so a card update recovers the payment right away.
This is a payment-recovery event
payment_method.attached is part of the failed-payment lifecycle. Handling it well, with retries, branded emails, a card update page, and stop-on-success, is what recovers the ~9% of MRR most SaaS lose to failed payments. See how to recover failed Stripe payments or skip the build with SubRevival.
Stop building webhook handlers
SubRevival consumes the failed-payment events for you and runs the full recovery stack, no endpoint to build, secure, or maintain. 5-minute Stripe OAuth, $19/mo flat.
Start Recovering RevenueFAQ
What does the Stripe payment_method.attached webhook event mean?
A payment method was attached to a customer.
When does payment_method.attached fire?
A customer adds or updates a card, often via your card update page.
What should I do when I receive a payment_method.attached event?
Retry any open or past_due invoices immediately so a card update recovers the payment right away.
Related events
Source: official Stripe events documentation.