Provision a Network Token for an Existing Instrument Identifier

This section shows you how to provision a network token for an existing instrument identifier.

Endpoint

Test:
POST
https://apitest.visaacceptance.com
/tms/v1/instrumentidentifiers/{instrumentIdentifierTokenId}/enrollment
Production:
POST
https://api.visaacceptance.com
/tms/v1/instrumentidentifiers/{instrumentIdentifierTokenId}/enrollment
instrumentIdentifierTokenId
 is the instrument identifier token ID returned in the
id
 field when you created the instrument identifier token. For more information, see Create an Instrument Identifier.

Required Fields for Provisioning a Network Token for an Existing Instrument Identifier

card.expirationMonth
card.expirationYear
card.securityCode
instrumentIdentifierTokenId
Include the ID of the instrument identifier token you want to retrieve in the URL path.
type

Optional Fields for Provisioning a Network Token for an Existing Instrument Identifier

card.securityCode

REST Example: Provisioning a Network Token for an Existing Instrument Identifier

Light Dark
Request
123456
{"type": "enrollable card",
  "card": {
    "expirationMonth": "12",
    "expirationYear": "2031",
    "securityCode": "089"
  }}
Response to a Successful Request
123456789101112131415161718192021
{"_links": {
    "self": {
      "href": "https://apitest.visaacceptance.comhttps://apitest.visaacceptance.com/tms/v1/instrumentidentifiers/7010000000016241111"
    },
    "paymentInstruments": {
      "href": "https://apitest.visaacceptance.comhttps://apitest.visaacceptance.com/tms/v1/instrumentidentifiers/7010000000016241111/paymentinstruments"
    }
  },
  "id": "7010000000016241111",
  "object": "instrumentIdentifier",
  "state": "ACTIVE",
  "tokenizedCard": {
    "state": "ACTIVE",
    "type": "visa"
  },
  "card": {
    "number": "411111XXXXXX1111"
  },
  "metadata": {
    "creator": "testrest"
  }}