On This Page

American Express Daily Updates

Card numbers in TMS are represented by instrument identifier
tokens. A card number and its associated instrument identifier
token are set to a CLOSED status under these circumstances:

The card network sends a direct account closed notification (response code ACL).

A new card number is issued to replace a cancelled card (response code NAN).

Account Updater updates customer and payment instrument tokens only when you specify them in the request. When you specify a customer token for update or harvest, only the customer's default payment instrument token is updated. When you do not specify the customer and payment instrument tokens, they can become associated with a closed instrument identifier token in the update batch or harvest. These results are detailed in the

additionalUpdates

section of the update report. To update customer tokens and payment instrument tokens, include them in a subsequent Account Updater batch API request, or send a direct call to the TMS REST API.

See the TMS Developer Guide at tms-overview.html

AMEX_MAINTENANCE Batch Method

{
  "version": "1.0",
  "reportCreatedDate": "2020-01-23T11:16:13Z",
  "batchId": "15797780137010000506182090",
  "batchSource": "AMEX_MAINTENANCE",
  "batchCaEndpoints": "AMEX",
  "batchCreatedDate": "2020-01-23T11:13:33Z",
  "totals": {
    "updatedRecords": 3,
    "rejectedRecords": 0,
    "caResponses": 3,
    "caResponsesOmitted": 0
  },
  "billing": {
    "nan": 1,
    "ned": 1,
    "acl": 1,
    "cch": 0
  },
  "records": [
    {
      "id": "562239661",
      "sourceRecord": {
        "token": "9CCD3AE24DD9E254E0533F36CF0A356E",
        "cardNumber": "371449XXXXX2009",
        "cardExpiryMonth": "02",
        "cardExpiryYear": "2021",
        "cardType": "003",
        "customerId": "9CCD3AE24DD9E254E0533F36CF0A356E",
        "paymentInstrumentId": "9CCD3AE24DD8E254E0533F36CF0A356E",
        "instrumentIdentifierId": "9CCD3AE24DD7E254E0533F36CF0A356E"
      },
      "responseRecord": {
        "response": "NAN",
        "reason": "800",
        "token": "9CCD3AE24DD9E254E0533F36CF0A356E",
        "cardNumber": "371449XXXXX0102",
        "cardType": "003",
        "instrumentIdentifierId": "9CCDC4D08BE0C16BE0533F36CF0A9916",
        "instrumentIdentifierCreated": "true",
        "cardExpiryMonth": "07",
        "cardExpiryYear": "2021",
        "additionalUpdates": [
          {
            "customerId": "8CCD3AE24DD8E254E0533F36CF0A355E",
            "paymentInstrumentId": "9CCD3AE24DD8E254E0533F36CF0A356D",
            "creator": "aura_regress_tms_report",
            "state": "CLOSED",
            "message": "This Payment Instrument contains the source card number, which is now closed. If required, you can update manually or through the AU REST API."
          }
        ]
      }
    }
      {
    "id": "562239711",
    "sourceRecord": {
      "token": "9CCD3AE24DF7E254E0533F36CF0A356E",
      "cardNumber": "371449XXXXX1100",
      "cardExpiryMonth": "02",
      "cardExpiryYear": "2021",
      "cardType": "003",
      "customerId": "9CCD3AE24DF7E254E0533F36CF0A356E",
      "paymentInstrumentId": "9CCD3AE24DF6E254E0533F36CF0A356E",
      "instrumentIdentifierId": "9CCD3AE24DF5E254E0533F36CF0A356E"
    },
    "responseRecord": {
      "response": "NED",
      "reason": "800",
      "cardExpiryMonth": "12",
      "cardExpiryYear": "2021"
      }
    },
    {
    "id": "562239751",
    "sourceRecord": {
      "token": "9CCD3AE24E0FE254E0533F36CF0A356E",
      "cardNumber": "371449XXXXX1226",
      "cardExpiryMonth": "02",
      "cardExpiryYear": "2021",
      "cardType": "003",
      "customerId": "9CCD3AE24E0FE254E0533F36CF0A356E",
      "paymentInstrumentId": "9CCD3AE24E0EE254E0533F36CF0A356E",
      "instrumentIdentifierId": "9CCD3AE24E0DE254E0533F36CF0A356E"
    },
    "responseRecord": {
      "response": "ACL",
      "reason": "800",
      "additionalUpdates": [
        {
          "customerId": "7CCD3AE24DD8E254E0533F36CF0A356A",
          "paymentInstrumentId": "9CCD3AE24E0EE254E0533F36CF0A356D",
          "creator": "aura_regress_tms_report",
          "state": "CLOSED",
          "message": "This Payment Instrument contains the source card number, which is now closed. If required, you can update manually or through the AU REST API."
          }
        ]
      }
    }
  ]
}

TOKEN_API Batch Method and Scheduler

{
  version": "1.0
  "reportCreatedDate": "2018-11-01T14:43:36Z",
  "batchId": "15410833473400000123332450",
  "batchSource": "SCHEDULER",
  "batchCaEndpoints": "VISA,MASTERCARD",
  "batchCreatedDate": "2018-11-01T14:42:27Z",
  "merchantReference": "Merchant Name",
  "totals": {
    "acceptedRecords": 2,
    "caResponses": 3,
    "rejectedRecords": 0,
    "updatedRecords": 2,
    "caResponsesOmitted": 1
    },
    "billing": {
      "nan": 1,
      "ned": 0,
      "acl": 1,
      "cch": 0
    },
    "records": [
      {
        "id": "4451434614",
        "sourceRecord": {
          "token": "4682345889876532701018",
          "cardNumber": "511111XXXXXX3604",
          "cardExpiryMonth": "09",
          "cardExpiryYear": "2021",
          "cardType": "002"
        },
        "responseRecord": {
          "response": "ACL",
          "reason": "800"
        }
      },
    {
      "id": "784311",
      "sourceRecord": {
      "token": "7020000000014008934",
      "cardNumber": "371000XXXXXX8115",
      "cardExpiryMonth": "01",
      "cardExpiryYear": "2021",
      "cardType": "003",
      "instrumentIdentifierId": "7020000000014008115"
      },
      "responseRecord": {
      "response": "NAN",
      "reason": "800",
      "token": "7020000000012513358",
      "cardNumber": "401000XXXXXX2753",
      "cardType": "001",
      "instrumentIdentifierId": "7020000000012512753",
      "instrumentIdentifierCreated": "true",
      "cardExpiryMonth": "08",
      "cardExpiryYear": "2021"
      }
    }
  ]
}

Batch Retrieval Error

{
  "_links": {
    "self": {
      "href": "https://api.smartpayfuse.barclaycard/accountupdater/v1/batches/
154108334734003332450/report"
    }
  },
  "code": "FORBIDDEN_RESPONSE",
  "correlationId": "0386623ab0eb47dfae61d273032f8202",
  "detail": "You are not authorized to access this resource",
  "localizationKey": "cybsapi.forbidden.response",
  "message": "Unauthorized Access"