On This Page

Provision a Network Token for a Card Number

This section describes how to provision a network token for a card number.

Network tokens that are provisioned by TMS are card-on-file (COF) tokens.

Endpoint

Test:

POST https://api.smartpayfuse-test.barclaycard/tms/v1/instrumentidentifiers

Production:

POST https://api.smartpayfuse.barclaycard/tms/v1/instrumentidentifiers

Required Fields for Provisioning a Network Token for a Card Number

card.number
card.expirationMonth
card.expirationYear
type

Optional Fields for Provisioning a Network Token for a Card Number

card.securityCode

REST Example: Provisioning a Network Token for a Card Number

Request

{
  "type": "enrollable card",
  "card": {
    "number": "4895379987X11515",
    "expirationMonth": "12",
    "expirationYear": "2031",
    "securityCode": "089"
  }
}

Response to a Successful Request

{
    "_links": {
        "self": {
            "href": "https://api.smartpayfuse-test.barclaycard/tms/v1/instrumentidentifiers/7030000000014911515"
        },
        "paymentInstruments": {
            "href": "https://api.smartpayfuse-test.barclaycard/tms/v1/instrumentidentifiers/7030000000014911515/paymentinstruments"
        }
    },
    "id": "7030000000014911515",
    "object": "instrumentIdentifier",
    "state": "ACTIVE",
    "tokenizedCard": {
    "state": "ACTIVE",
    "number": "489537XXXXXX5914",
    "expirationMonth": "12",
    "expirationYear": "2022",
    "type": "visa",
    "card": {
      "suffix": "1515",
      "expirationMonth": "12",
      "expirationYear": "2031"
    },
    "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": "testrest"
    }
}