On This Page
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-cardsProduction:
POST
https://api.cybersource.com
/tms/v2/tokenized-cardsProduction in India:
POST
https://api.in.cybersource.com
/tms/v2/tokenized-cardsRequired Fields for Provisioning a Network Token for a
Token
- card.number
- Set to the tokenized card number. Whensourceis set toTOKEN, this field value must be a digital network token to provision a COF network token.
- card.expirationMonth
- card.expirationYear
- card.securityCode
- createInstrumentIdentifier
- Set totrue.
- source
- Set toTOKEN. The value set forcard.numbermust 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.
Related Information
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" } }