Account Updater

Keep customer card information up-to-date.

The Account Updater API resource is a group of endpoints for sending and managing Account Updater requests through our Platform API. When you create an Account Updater request, Account Updater programs through the card brands automatically check and update your customers’ payment card information. Use this to keep payment information in your Customer Vault up-to-date, minimizing declines for repeat customer transactions due to expired cards, closed accounts, or reissued cards.

This page gives an overview of our Account Updater API resource and the API requests it supports. Subpages provide implementation guides for a few important requests. See Account Updater in our API Reference for endpoints and details on all supported transactions. To manage the service through the Maast Manager portal, see Account Updater in Maast Manager.


The Account Updater API resource has the following benefits:

  • Prevents declined payments - By keeping card information up-to-date, it helps prevent declined payments and related delays in receiving payments.
  • Updates frequently - Based on the configured day of the month, the service harvests cards once a month and sends a request for updated information to the card brands for the harvested cards. It will automatically update the card information on file based on the results.
  • Under control - You can add cards to the harvest and remove them or place them on a temporary hold from harvest at any time.
  • Lightens your workload - The API reduces your need to contact customers to manually update their payment card information.

The resource supports the following cards:

  • Visa
  • Mastercard
  • American Express
  • Discover

Note that Account Updater's availability relies on the capabilities of the issuing bank. If you wish to confirm whether a card is eligible for Account Updater, please check with the bank.

To check the status of an Account Updater request, do any of the following:

  • Subscribe to the account_updater_request_created webhook event to be notified when the request creation is complete. Do so via Maast Manager or a Webhooks API request.
  • Subscribe to the account_updater_request_completed webhook event to be notified when the request response is received. Do so via Maast Manager or Webhooks API request.
  • When you send Submit Account Updater Request, save the request_id value from the response. Use that value in Get Summary of an Account Updater Request to check the status of your request at any time.

This resource supports several requests. We offer API reference for all supported requests and detailed implementation guides for some.

We have guides for the following API functions:

See Account Updater in API Reference for the following additional functions supported by the API:

How It Works

Account Updater is activated through the Maast Manager portal. After that, it can be managed through either the portal or API requests. The workflow is as follows:

  1. Sign Up - The merchant signs in to the Maast Manager portal and enables Account Updater. They agree to accept the associated fees, and they set the day of the month for Account Updater to harvest cards.
  2. Harvest - On the selected day each month, Account Updater automatically harvests, checks and updates the numbers and expiration dates of card data stored in the merchant's Customer Vault.
  3. Configure - Optionally, the merchant can further configure or cancel harvests and get reports on the process. They can do so using the portal, Account Updater API requests, and/or Webhooks API requests.