On This Page

Create an Instrument Identifier Token

Before you can set up and authenticate a customer using the Passkey Service, you must create an instrument identifier token to contain the customer's payment credentials.

Instrument identifier tokens represent tokenized payment account numbers. Tokenized payment account information includes a primary account number (PAN) for card payments, or a US or Canadian bank account number and routing number for an ACH bank account. An instrument identifier token can exist independently, or it can be associated with a payment instrument.

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

card.number

Related Information

API Field Reference for the REST API

Optional Fields for Creating an Instrument Identifier

bankAccount.number
bankAccount.routingNumber
billTo.address1
billTo.address2
billTo.administrativeArea
billTo.country
billTo.locality
billTo.postalCode
card.expirationMonth
card.expirationYear
card.securityCode
processingInformation.authorizationOptions.initiator. merchantInitiatedTransaction.previousTransactionID

Related Information

API Field Reference for the REST API

REST Example: Creating a Card Instrument Identifier

Request

{
  "card": {
    "number": "4111XXXX11111111"
  }
}

Response to a Successful Request

{
  "_links": {
    "self": {
      "href": "https://apitest.cybersource.com/tms/v1/instrumentidentifiers/7010000000016241111"
    },
    "paymentInstruments": {
      "href": "https://apitest.cybersource.com/tms/v1/instrumentidentifiers/7010000000016241111/paymentinstruments"
    }
  },
  "id": "7010000000016241111",
  "object": "instrumentIdentifier",
  "state": "ACTIVE",
  "card": {
    "number": "411111XXXXXX1111"
  },
  "metadata": {
    "creator": "testrest"
  }
}