---
title: "Provision a Network Token"
method: POST
path: "/network-tokens"
tags: ["Network Tokens"]
---

# Provision a Network Token

`POST /network-tokens`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/network-tokens`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `vault:network-tokens`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/network-tokens/post.ts> (a function with typed inputs; its response is checked against the schema)

<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.

## Request body

- NetworkTokensRequest
  - `source` union, required: The source object
    - object: An existing payment source
      - `type` string, required: The source type
      - `id` string, required: The card instrument
    - object: Card details
      - `type` string, required: The source type
      - `number` string, required: The card number.
      - `cvv` string: The CVV number for the card
      - `expiry_month` string, required: The expiry month of the card.
      - `expiry_year` string, required: The four-digit expiry year of the card.

## Response `200`

Responding with existing network token

- NetworkTokensResponse
  - `card` NetworkTokensCard, required: The card details.
    - `last4` string, required: The last four digits of the card number.
    - `expiry_month` string, required: The card's expiration month.
    - `expiry_year` string, required: The card's expiration year.
  - `network_token` object, required: Network token details
    - `id` string, required: Unique token ID assigned by Checkout.com for each token
    - `state` 'active' | 'suspended' | 'inactive', required: Token status
    - `number` string, required: The network token number.
    - `expiry_month` string, required: The network token's expiration month.
    - `expiry_year` string, required: The network token's expiration year.
    - `type` 'vts' | 'mdes', required: The type of token
    - `payment_account_reference` string: Unique Payment account reference value assigned to payment account. All affiliated payment tokens, as well as the underlying PAN, have the same PAR.
    - `created_on` string, date-time, required: When the network token was created
    - `modified_on` string, date-time, required: When the network token was modified
  - `token_requestor_id` string: Token requestor ID
  - `token_scheme_id` string: The scheme-specific identifier for the network token. For Visa, this is equivalent to the `vProvisionedTokenID`. For Mastercard, this is equivalent to the `tokenUniqueReference`.
  - `_links` NetworkTokensResponseLinks
    - `self` Link
      - `href` string, required: The link URL
    - `cryptogram` Link
      - `href` string, required: The link URL
    - `card-art` Link
      - `href` string, required: The link URL

## Other responses

- `201`: Network token provisioned
- `401`: Unauthorized
- `403`: Forbidden
- `415`: Unsupported Media Type
- `422`: Invalid data was sent
- `500`: Internal Server Error
- `502`: Bad Gateway
- `504`: Gateway Timeout

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)