HomeProduct DocsAPI ReferenceChangelog
RecurlyAPI GuidesRecurly.jsWebhooksAPI ReferenceSupportBook demo
Product Docs

Launchpad phase one: Account Updater

Eliminate payment credit card declines before renewals occur. Learn how to configure Recurly’s Account Updater, locate your Mastercard MCC and Amex SE numbers, exploit real-time gateway updates, and lower involuntary subscription churn.

Upcoming: Join our CSMs live. Register →
Launch Launch · Launchpad Phase One

Account Updater

Keep card data current automatically so renewals succeed before expired or replaced cards ever reach a failure state.

Navigation Menu

How Account Updater works

Account Updater queries Visa, Mastercard, Discover, and Amex card network files to catch changes in card numbers or expiry dates before your next renewal attempt. For most gateways, checks run days before billing. Stripe and Adyen support real-time updates during the transaction itself. Subscribers don't have to take action — their renewal just succeeds.

Account Updater and dunning are complementary: Account Updater reduces the number of payments that fail; dunning recovers the ones that still do (like NSF or lost cards).

Trail guide: Account Updater setup

~3 min
How Account Updater works, which card networks are supported, and where to enable it in Recurly.

Enable Account Updater

Visa & Discover — enabled directly

Toggle on in Configuration → Payment Settings. No additional configuration needed.

Mastercard & Amex — requires codes

Mastercard requires your 4-digit MCC code. Amex requires a 10-digit SE Number (direct accounts only; Amex OptBlue not supported).

Where to find your codes

Your MCC (Merchant Category Code) is on your bank processing statement. Your Amex SE Number is on your direct American Express merchant statement.

1

Open Payment Settings

Navigate to Configuration → Payment Settings. Account Updater toggle controls appear at the top of this page. Recurly Docs: Payment Settings.

2

Enable Visa and Discover

Toggle both on directly — no codes required. These two networks cover the majority of most subscriber bases. Recurly Docs: Account Updater.

3

Enter Mastercard MCC and Amex SE Number

Enter your 4-digit MCC for Mastercard. Enter your 10-digit SE Number for Amex if you have a direct Amex account. Skip Amex if you're on Amex OptBlue via your gateway. How to enable Account Updater/

Account Updater checklist

Questions about Account Updater?

Our Customer Success team runs weekly Global Office Hours sessions where you can bring your real configuration questions — branding, plan structure, dunning setup, migration strategy, pricing model decisions. No agenda required.

Register for Office Hours →