What this operation supports in Stripe
Updates an existing customer's details, such as email, name, default payment method, or metadata, by their ID.
Implementation details
Updating a customer's default payment method here changes what's used for future off-session charges (like subscription renewals) -- it doesn't retroactively affect payments already made.
Operational considerations
Keeping a customer's default payment method current matters specifically for subscription billing, where Stripe charges that stored method automatically on each renewal.
Use cases
Keep customer records in sync across systems.
- Update contact details after a CRM sync.
- Add or modify metadata for segmentation and reporting.
- Adjust default payment methods or subscriptions based on new info.
- Support compliance by updating tax or regional data.