Network Tokens

Provision a Network Token

<span style="font-size: 12px; font-weight: 500; color: rgb(0, 0, 0); background-color: rgb(255, 176, 97); border-radius: 4px; padding: 2px 6px" >Beta</span><p></p> Provisions a network token synchronously. If the merchant stores their cards with Checkout.com, then source ID can be used to request a network token for the given card. If the merchant does not store their cards with Checkout.com, then card details have to be provided.

post/network-tokens

Request

Request body

Example request

{
  "source": {
    "type": "id",
    "id": "src_wmlfc3zyhqzehihu7giusaaawu"
  }
}

Response

Responding with existing network token

token_requestor_idstring

Token requestor ID

token_scheme_idstring

The scheme-specific identifier for the network token.

For Visa, this is equivalent to the vProvisionedTokenID. For Mastercard, this is equivalent to the tokenUniqueReference.

Example response

{
  "card": {
    "last4": "6378",
    "expiry_month": "5",
    "expiry_year": "2025"
  },
  "network_token": {
    "id": "nt_xgu3isllqfyu7ktpk5z2yxbwna",
    "state": "active",
    "number": "5436424242424242",
    "expiry_month": "5",
    "expiry_year": "2025",
    "type": "vts",
    "payment_account_reference": "5001a9f027e5629d11e3949a0800a",
    "created_on": "2020-02-11T15:57:32.4350000+00:00",
    "modified_on": "2020-02-11T15:57:32.4350000+00:00"
  },
  "token_requestor_id": "1234567890",
  "token_scheme_id": "scheme_visa_001",
  "_links": {
    "self": {
      "href": "https://{prefix}.api.checkout.com/network-tokens/nt_xgu3isllqfyu7ktpk5z2yxbwna"
    },
    "cryptogram": {
      "href": "https://{prefix}.api.checkout.com/network-tokens/nt_xgu3isllqfyu7ktpk5z2yxbwna/cryptograms"
    },
    "card-art": {
      "href": "https://card-art.checkout.com/00340aa7bd3de35cb1048369450d8df4"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.