# Request provisioning for a network token and returns a reference for use later

Request to provision a network token.

Endpoint: POST /tokens/network
Version: 3
Security: BasicAuth

## Request fields (application/vnd.worldpay.tokens-v3.hal+json):

  - `paymentInstrument` (object, required)

  - `paymentInstrument.type` (string, required)

  - `paymentInstrument.cardHolderName` (string)
    The name on your customer's card.

  - `paymentInstrument.cardExpiryDate` (object)

  - `paymentInstrument.cardExpiryDate.month` (integer, required)

  - `paymentInstrument.cardExpiryDate.year` (integer, required)

  - `paymentInstrument.cardNumber` (string)

  - `paymentInstrument.href` (string)

  - `merchant` (object, required)
    An object that contains information about your merchant account.

  - `merchant.entity` (string, required)
    Identifies merchant account for billing, reporting and reconciliation. Contact your Worldpay Implementation Manager for more details.

## Response 200 fields (application/vnd.worldpay.tokens-v3.hal+json):

  - `tokenReference` (string, required)

  - `paymentInstrument` (object, required)

  - `paymentInstrument.type` (string, required)

  - `paymentInstrument.firstSix` (string, required)

  - `paymentInstrument.lastFour` (string, required)

  - `paymentInstrument.cardExpiryDate` (object, required)

  - `paymentInstrument.cardExpiryDate.month` (integer, required)

  - `paymentInstrument.cardExpiryDate.year` (integer, required)

  - `paymentInstrument.paymentAccountReference` (string, required)

  - `tokenPaymentInstrument` (object)

  - `tokenPaymentInstrument.status` (string, required)

  - `tokenPaymentInstrument.type` (string, required)

  - `tokenPaymentInstrument.tokenNumber` (string, required)

  - `tokenPaymentInstrument.expiryDate` (object, required)

  - `tokenPaymentInstrument.expiryDate.month` (integer, required)

  - `tokenPaymentInstrument.expiryDate.year` (integer, required)

  - `provisioningErrors` (array)
    For a full list of provisioning errors, please see [Network token error responses](./network-token-errors.md).

  - `provisioningErrors.errorCode` (string, required)

  - `provisioningErrors.providerErrorCode` (string, required)

  - `provisioningErrors.source` (string, required)

  - `provisioningErrors.context` (string, required)

  - `provisioningErrors.message` (string, required)

  - `_links` (object, required)

## Response 400 fields (application/vnd.worldpay.tokens-v3.hal+json):

  - `errorName` (string, required)

  - `message` (string, required)

  - `validationErrors` (array)

  - `validationErrors.errorName` (string, required)

  - `validationErrors.message` (string, required)

  - `validationErrors.jsonPath` (string)

## Response 401 fields (application/vnd.worldpay.tokens-v3.hal+json):

  - `errorName` (string, required)

  - `message` (string, required)