API Overview

Account Updater
- Recent Revisions to This Document

Introduction to Account Updater
- Tokenization
  - Token Harvest Updates
  - Token Selective Batch Updates
- Storing PANs
- Enabling Account Updater
  - Smartpay Fuse Portal Permissions
- Terms of Use

Token Updates
- Token Harvest
- Token Batch Updates
  - Submitting Visa and Mastercard One-Time Updates
  - Registering Tokens for American Express Daily Updates
  - Batch Creation Request Examples
  - Batch Creation Response Examples
  - Retrieving Batch Status
    - Visa and Mastercard One-Time Updates
    - One-Time Batch Update Response
    - Customer Token Batch Report Responses
  - American Express Daily and Token Harvest Update Reports
  - Retrieving a Batch with a Batch ID
  - American Express Daily Updates

PAN Updates
- Creating Security Keys
  - Authentication Key
  - PGP Public/Private Key
- Formatting a Request File
  - Request Header Record
  - Request Detail Record
  - Request Footer Record
  - Request File Examples
- Uploading a Request File
- Email Notification
- Viewing the Status of a Batch File
- Downloading a Response File
- Response File Records
  - Response Header Record
  - Response Detail Record
  - Response Footer Record
  - Response File Examples

Testing
- American Express Test Card Numbers
- Mastercard Test Card Numbers
- Visa Test Card Numbers

API Fields
- Request Fields
- Response Fields

PAN Upload Response Codes and Reason Codes

On This Page

Token Harvest

On an agreed-upon monthly date, Account Updater submits your tokenized cards to Visa and Mastercard for updates. American Express tokenized cards are automatically enabled for Cardrefresher daily, and deleted or updated tokens are de-enrolled automatically.

IMPORTANT

The Account Updater harvest is configured at the Transacting ID level and can only request updates for TMS tokens it has created. If multiple TMS Transacting IDs are creating TMS tokens, each ID must be set up for the Account Updater.

You must retrieve American Express reports daily, or Visa and Mastercard reports monthly. For more information about reports, see Retrieving Batch Status.

It is best practice to request updates for your tokens 3 to 5 days before your billing cycle begins. You can choose any calendar day, from the 1st through the 28th.

Back to top