Provision a Network Token for a Consumer
When you provision a network token for an individual consumer in a wallet, you can manage
the network token and payment credentials separately for that consumer. Provisioning
network tokens for a consumer is supported for American Express, Mastercard, and Visa.
This section describes how to provision a network token for a card number and a consumer
ID.
Network tokens that are provisioned by
TMS
are card-on-file (COF) tokens.IMPORTANT
You must be enabled as an ECOM enabler in the Visa Token Service
(VTS) to provision a network token with a consumer ID. For more information, contact
your
Cybersource
account representative.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 COF Network Token for
a Consumer
- card.number
- card.expirationMonth
- card.expirationYear
- card.securityCode
- createInstrumentIdentifier
- Set totrue.
- source
- Set toONFILE.
- 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
Consumer
Request
{ "createInstrumentIdentifier": true, "source": "ONFILE", "consumerId": "123456", "card": { "number": "X895379980000580", "expirationMonth": "12", "expirationYear": "2023", "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": "ONFILE", "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" } }