Stripe card account updater: How automatic card updates work
Stripe's card account updater keeps saved cards working after a customer's bank issues them a new one. It pulls the new card number or expiration date from the card networks, so the saved card keeps working. Here's how it works, which cards it covers, what it costs, and what to do when a payment still fails on an old card.
What is the card account updater?
Stripe's docs call it automatic card updates. When a customer's bank replaces their card, for example because it expired or was reported lost or stolen, Stripe works with the card networks to update the saved card details. Updates cover the expiration date and the card number. Stripe's payments optimization docs say outdated card information "is a common source of declines for online businesses".
It's one of three features Stripe groups as Authorization Boost, along with Adaptive Acceptance and network tokens, and Stripe's docs describe them as working on card-not-present payments, such as online checkouts and subscription renewals.
Which cards it covers
The updater only works when the card's issuer shares new details with the network. Stripe's card documentation says this is widely supported in the United States, where Stripe can update most American Express, Visa, Mastercard, and Discover cards issued there, and that international support varies from country to country. Its Authorization Boost page lists the same four networks.
Stripe also says it isn't possible to identify which cards support automatic updates, so you can't check a customer's card in advance.
What it costs
On Stripe's standard payments pricing, the card account updater costs nothing extra. Stripe's pricing page lists Authorization Boost, which includes it, as "included at no additional charge for businesses on standard payments pricing". On custom payments pricing, Authorization Boost is 0.2% per successful online card transaction, or the card account updater on its own is 25¢ per update.
How to tell when a card was updated
Stripe sends a payment_method.automatically_updated webhook event when a card network updates a saved card, and payment_method.updated when a card is changed through an API call. Both include the card's new expiration date and last four digits. If the card number changed, the card's fingerprint changes too.
In the Dashboard, the Optimization page shows Stripe's estimates of the payments each Authorization Boost feature recovered, including the card account updater.
Network tokens
Network tokens do a similar job by a different route. A network token stands in for the card number, and Stripe's docs say it can help a payment go through "with the most up-to-date credentials, even if the underlying card data has changed". Stripe supports network tokens for Visa, Mastercard, and American Express, and its AI decides when to retry a payment with the network token instead of the card number. They're part of Authorization Boost too, and on custom interchange pricing without it they cost 15¢ per token provisioned.
When automatic updates don't help
The updater can only pass along a new card the bank has issued. If the issuer doesn't take part, or the customer closed the account without getting a replacement, the saved card stays as it is and the next charge can fail. A retry won't fix that on its own: Stripe can't retry a payment that returns a hard decline code such as lost_card or stolen_card until there's a new payment method. Our guide to Stripe decline codes lists them.
Two Stripe settings help before and after that point. Both are under Email notifications and customer management in Stripe's revenue recovery settings:
- Send emails about expiring cards emails the customer 1 month before the card on file expires, when it's their default payment method.
- Send emails when card payments fail emails the customer after each failed payment, with a link to update their payment method. Our guide to Stripe's failed payment emails covers the setup and the limits.
If the customer still hasn't updated their card, Recoura emails them a link to pay the invoice on Stripe's hosted page. For soft declines it steps in only after Smart Retries has finished; hard declines don't wait for that. When the customer pays a subscription invoice with a new card, Recoura makes that card the subscription's default, so the next renewal charges the new card instead of the old one.
Stripe card account updater FAQ
Does Stripe update expired cards automatically?
It tries to. Stripe's card account updater pulls new expiration dates and card numbers from the card networks when the customer's bank takes part. It's widely supported for cards issued in the United States, and international support varies.
How much does Stripe's card account updater cost?
On standard payments pricing it's included at no extra charge, as part of Authorization Boost. On custom payments pricing without Authorization Boost, it's 25¢ per update.
Is the card account updater part of Authorization Boost?
Yes. Authorization Boost includes Adaptive Acceptance, the card account updater, and network tokens.
Which webhook tells me Stripe updated a card?
payment_method.automatically_updated, for updates from the card network. Stripe sends payment_method.updated when a card is changed through an API call. Both include the new expiration date and last four digits.
Why did a payment fail if Stripe updates cards automatically?
The updater only helps when the customer's bank has issued a new card and shares it with the network. If the issuer doesn't take part, the card was closed without a replacement, or the payment failed for another reason, the customer has to add a new card themselves.