Keep card-on-file credentials current using Visa Account Updater (VAU) and Mastercard Automatic Billing Updater (ABU)

domain: developer.visa.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Enroll your merchant account in VAU through your acquirer and in Mastercard ABU through your Mastercard-certified processor; each network has its own enrollment process and file format requirements.
  2. Submit a batch inquiry file containing the stored PANs and expiry dates you want to check — format differs per network but generally requires the PAN, current expiry, and a merchant reference.
  3. Parse the response file: update records may include a new PAN, new expiry, a closure indicator (account closed), or a contact cardholder indicator; apply each update type to your vault accordingly.
  4. For real-time updates, configure your processor to request VAU/ABU checks at authorization time — some processors support inline updater calls that return updated card data in the authorization response when the stored credential fails.
  5. After receiving updated card data, re-attempt declined recurring charges using the new PAN or expiry within the window allowed by your processor's retry policies.
  6. Purge or flag records that return a closure or contact cardholder response to avoid continued retry attempts on permanently closed accounts.

Known gotchas

Related routes

Understand Mastercard Automatic Billing Updater (ABU) concepts for keeping stored card credentials current for recurring merchants
Account updater · 6 steps · unrated
Understand Visa Account Updater (VAU) batch flow concepts for refreshing stored PANs before recurring charge attempts
Account updater · 6 steps · unrated
Configure Mastercard Automatic Billing Updater (ABU) to refresh stored PANs and reduce expiry-driven declines
developer.mastercard.com · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans