On This Page

Create an Instrument Identifier and Network Token Using EMV Tags

This section describes how to create an instrument identifier and a network token using EMV tags.

Endpoint

Test:

POST https://apitest.cybersource.com/tms/v1/instrumentidentifiers

Production:

POST https://api.cybersource.com/tms/v1/instrumentidentifiers

Production in India:

POST https://api.in.cybersource.com/tms/v1/instrumentidentifiers

Required Fields for Creating an Instrument Identifier and Network Token Using EMV Tags

type: Set to
enrollable card
when you are provisioning a network token.
pointOfSaleInformation.emvTags.tag
pointOfSaleInformation.emvTags.value
pointOfSaleInformation.emvTags.source: Set to one of these values:
CARD
TERMINAL

Related Information

API Field Reference for the REST API

Optional Field for Creating an Instrument Identifier and Network Token Using EMV Tags

card.securityCode

Related Information

API Field Reference for the REST API

REST Example: Creating an Instrument Identifier and Network Token Using EMV Tags

These examples include the minimum required EMV tags for card information. You can include more EMV tags for the card tap in your request.

Request to Create an Instrument Identifier with EMV Tag 5A

{
  "pointOfSaleInformation": {
    "emvTags": [
      {
        "tag": "5A",
        "value": "4111111111111111",
        "source": "CARD"
      }
    ]
  }
}

Request to Create an Instrument Identifier with EMV Tag 57

{
  "pointOfSaleInformation": {
    "emvTags": [      
      {
        "tag": "57",
        "value": "4111111111111111D30092011234567890F",
        "source": "CARD"
      }
    ]
  }
}

Request to Create an Instrument Identifier and Provision a Network Token with EMV Tags 5A and 5F24

{
  "type": "enrollable card",
  "card": {
    "securityCode": "123"
  },
  "pointOfSaleInformation": {
    "emvTags": [
      {
        "tag": "5A",
        "value": "4111111111111111",
        "source": "CARD"
      },
      {
        "tag": "5F24",
        "value": "YYMMDD",
        "source": "CARD"
      }
    ]
  }
}

Request to Create an Instrument Identifier and Provision a Network Token with EMV Tag 57

{
  "type": "enrollable card",
  "card": {
    "securityCode": "123"
  },
  "pointOfSaleInformation": {
    "emvTags": [
      {
        "tag": "57",
        "value": "4111111111111111D30092011234567890F",
        "source": "CARD"
      }
    ]
  }
}

Request to Create an Instrument Identifier and Provision a Network Token with Multiple EMV Tags

{
  "type": "enrollable card",
  "source": "CONTACTLESS",
  "card": {
    "securityCode": "123"
  },
  "pointOfSaleInformation": {
    "emvTags": [
      {
        "tag": "5A",
        "value": "4111111111111111",
        "source": "CARD"
      },
      {
        "tag": "5F24",
        "value": "YYMMDD",
        "source": "CARD"
      },
      {
        "tag": "57",
        "value": "4111111111111111D30092011234567890F",
        "source": "CARD"
      },
      {
        "tag": "9F35",
        "value": "22",
        "source": "TERMINAL"
      }
    ]
  }
}

Response to a Successful Request

{
  "id": "7030080000051311515",
  "object": "instrumentIdentifier",
  "state": "ACTIVE",
  "tokenizedCard": {
    "id": "09CBCE20D414BB07E063AF598E0A4F1F",
    "state": "ACTIVE",
    "enrollmentId": "93e7ccff2d64fb4500b4158e45059d02",
    "tokenReferenceId": "5eaec012172e13a9aabd19549bde5a02",
    "paymentAccountReference": "V0010013019326121174070050420",
    "number": "489537XXXXXX0711",
    "expirationMonth": "09",
    "expirationYear": "2030",
    "type": "visa",
    "card": {
      "suffix": "1111",
      "expirationMonth": "09",
      "expirationYear": "2030",
      "issueDate": "2025-01-01",
      "activationDate": "2025-01-01",
      "expirationPrinted": "Y",
      "securityCodePrinted": "Y",
      "termsAndConditions": {
        "id": "09CBCE20D414BB07E063AF598E0A4F1F",
        "url": "<cardMetaData.contactWebsite>"
      }
    },
    "metadata": {
      "cardArt": {
        "combinedAsset": {
          "id": "84cfb836af434859be62c766bdc9e510",
          "_links": {
            "self": {
              "href": "/tms/v2/tokens/7030080000051311515/vts/assets/card-art-combined"
            }
          }
        }
      },
      "issuer": {
        "name": "issuing bank name",
        "shortDescription": "The Bank Card",
        "longDescription": "The Bank Card Platinum Rewards",
        "country": "Country of issuing Bank",
        "accountPrefix": "BIN",
        "email": "[email protected]",
        "phoneNumber": "1112223333",
        "url": "http://www.example.com"
      }
    }
  },
  "card": {
    "number": "489537XXXXXX1515"
  },
  "issuer": {
    "paymentAccountReference": "V0010013019326121174070050420"
  },
  "metadata": {
    "creator": "creator"
  }
}