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

TBD.

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

  - `_links` (object, required)