On This Page

Batch Creation Request Examples

TMS supports these types of tokens

Customer

Payment instrument

Instrument identifier

Customer tokens and payment instrument tokens store the expiration date in addition to the PAN. Instrument identifier tokens store only the PAN.

Each batch request should contain only one token type: customer, payment instrument, or instrument identifier.

Account Updater requires the existing PAN and expiration date. If you are using instrument identifier tokens, you must also to specify the expiration date.

Creating a Batch of Two Customer or Payment Instrument Tokens

{
  "type": "oneOff",
  "included": {
    "tokens": [
      {
        "id": "3FA02EB4E49B65FDA194B38994B1F3F3"
      },
      {
        "id": "D1944BD9A7F9052BE431A276EB492C39"
      }
    ]
  },
  "merchantReference": "Merchant reference",
  "notificationEmail": "[email protected]"
}

Creating a Batch of Two Instrument Identifier Tokens

{
  "type": "amexRegistration",
  "included": {
    "tokens": [
      {
        "id": "7B1F41664F08F6DD3BB1C63892907524",
          "expirationMonth": "12",
          "expirationYear": "2021"
      },
      {
        "id": "E8F44CFA7EBEADDB06A5A9625E7F8696",
          "expirationMonth": "12",
          "expirationYear": "2021"
      }
    ]
  },
  "merchantReference": "Merchant reference",
  "notificationEmail": "[email protected]"
}