Provision a Network Token for a Token

This section shows you how to create a network token for a given token.
Network tokens that are provisioned by
TMS
are card-on-file (COF) tokens.

Endpoint

Test:
POST
https://apitest.cybersource.com
/tms/v2/tokenized-cards
Production:
POST
https://api.cybersource.com
/tms/v2/tokenized-cards
Production in India:
POST
https://api.in.cybersource.com
/tms/v2/tokenized-cards

Required Fields for Provisioning a Network Token for a Token

card.number
Set to the tokenized card number. When
source
is set to
TOKEN
, this field value must be a digital network token to provision a COF network token.
card.expirationMonth
card.expirationYear
card.securityCode
createInstrumentIdentifier
Set to
true
.
source
Set to
TOKEN
. The value set for
card.number
must be a digital network token to provision a COF network token.
consumerId
When this field is not included, a network token is provisioned only for the PAN in the request.

REST Example: Provisioning a Network Token for a Token

Request
{ "createInstrumentIdentifier": true, "source": "TOKEN", "card": { "number": "X621943123037127", "expirationMonth": "12", "expirationYear": "2025", "securityCode": "123" } }
Response to a Successful Request
{ "_links": { "self": { "href": "/tms/v2/tokenized-cards/7030000000014911515" }, "instrumentidentifier": { "href": "/tms/v1/instrument-identifier/7030000000042974378" } }, "id": "7030000000014911515", "object": "tokenizedCard", "state": "ACTIVE", "source": "TOKEN", "enrollmentId": "96eb80a56b76ae1d486e14f40b3d7a01", "tokenReferenceId": "059ae2f74835647400c219884b7bc601", "paymentAccountReference": "V0010013022298169667504231315", "number": "489537XXXXXX9215", "expirationMonth": "10", "expirationYear": "2031", "type": "001", "card": { "suffix": "0580", "expirationMonth": "12", "expirationYear": "2023" }, "metadata": { "cardArt": { "combinedAsset": { "id": "d3225702-354a-4f17-8c40-1727de7ffa57", "_links": { "self": { "href": "/tms/v2/tokens/7030000000042974378/mdes/assets/card-art-combined" } } } }, "issuer": { "name": "METROBANK CARD CORPORATION (A FINANCE COMPANY)", "shortDescription": "METROBANK CARD CORPORATION" }, "creator": "testrest" } }