{"templateId":"markdown","versions":[{"version":"v1","label":"v1","link":"/products/tokens/v1/create-a-network-token","default":false,"active":false,"folderId":"13618f6a"},{"version":"v2","label":"v2","link":"/products/tokens/v2/create-a-network-token","default":false,"active":false,"folderId":"13618f6a"},{"version":"v3","label":"v3","link":"/products/tokens/create-a-network-token","default":true,"active":true,"folderId":"13618f6a"}],"sharedDataIds":{"sidebar":"sidebar-products/tokens/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/tokens/openapi"},"props":{"metadata":{"markdoc":{"tagList":["partial","tabs","tab","code-snippet"]},"custom_product":"Tokens","type":"markdown"},"seo":{"title":"Create a network token","description":"Worldpay for Developers - docs, code examples, resources and tools. Everything you need to build your omnichannel payment solution.","siteUrl":"https://docs.worldpay.com/access","image":"/access/assets/worldpay-logo-light.21b7daf79984773a9fcd7d4fbcb07ae5289dfffd6023c4c3dca720c7058e53dc.33f780a6.svg","keywords":"documentation, api, openapi, sdks, developer, payments, json, payouts, 3ds","jsonLd":{"@context":"https://schema.org","@type":"Organization","url":"https://docs.worldpay.com/access","name":"Worldpay"},"meta":[{"name":"google-site-verification","content":"zjziIKaP3ImsqsfhYnEBnq1R85UabiSwl7HTXuwtZuo"},{"name":"doc_product","content":"Access"},{"name":"doc_category","content":"Documentation"}],"llmstxt":{"hide":false,"sections":[{"title":"Payments API","description":"Payment orchestration API combining fraud assessment, 3ds authentication, SCA exemptions, Worldpay Token creation and a card or wallet based payment.","includeFiles":["products/payments/@20240601/**/*"],"excludeFiles":[]},{"title":"Payment Queries API","description":"Querying your payments data, based on a variety of parameters.","includeFiles":["products/payment-queries/@v1/**/*"],"excludeFiles":[]},{"title":"Card BIN Data API","description":"Provides detailed information about a card.","includeFiles":["products/card-bin/@v1/**/*"],"excludeFiles":[]},{"title":"3DS Authentication API","description":"Request 3DS authentication to protect against fraud, be SCA compliant and to shift liability using this standalone API.","includeFiles":["products/3ds/@v3/**/*"],"excludeFiles":[]},{"title":"FraudSight API","description":"Request a risk assessment and receive a response with an outcome (e.g. lowRisk) using this standalone API.","includeFiles":["products/fraudsight/@v1/**/*"],"excludeFiles":[]},{"title":"Checkout SDK","description":"Integrate using our clientside SDKs for both web and native devices. Benefit from SAQ-A/PCI-SSF compliance.","includeFiles":["products/checkout/web/@v2/**/*","products/checkout/ios/@v4/**/*","products/checkout/android/@v4/**/*","products/checkout/react-native/@v3/**/*","products/checkout/flutter/@v1/**/*"],"excludeFiles":[]},{"title":"Tokens API","description":"Minimizes the exposure of sensitive card details and increases the security of your customer's card details.","includeFiles":["products/tokens/@v3/**/*"],"excludeFiles":[]},{"title":"Card Payments API","description":"Request a card payment using this standalone API, requires separate requests for 3DS, Fraud assessment etc.","includeFiles":["products/card-payments/@v7/**/*"],"excludeFiles":[]},{"title":"Card Verifications API","description":"Verify your customer's card to maximize your authentication rates.","includeFiles":["products/card-verifications/@v6/**/*"],"excludeFiles":[]},{"title":"Account Payouts API","description":"Send funds to your customer's bank accounts and search for payouts using parameters.","includeFiles":["products/account-payouts/@20250101/**/*"],"excludeFiles":[]},{"title":"APMs","description":"Pay using eWallets, bank transfers, direct debits, local card schemes, Postpay and eInvoice/ Buy Now Pay Later.","includeFiles":["products/apms/@20240701/**/*"],"excludeFiles":[]},{"title":"Balance API","description":"Request your account details for a single account or all accounts under an entity.","includeFiles":["products/balance/@20250101/**/*"],"excludeFiles":[]},{"title":"Card Payouts API","description":"Send funds to your customer's cards.","includeFiles":["products/card-payouts/@v4/**/*"],"excludeFiles":[]},{"title":"Events (Webhooks)","description":"Receive status updates from Access Worldpay by setting up a webhook.","includeFiles":["products/events/@v1/**/*"],"excludeFiles":[]},{"title":"FX API","description":"Manage Foreign Exchange (FX) on your payments.","includeFiles":["products/fx/@v1/**/*"],"excludeFiles":[]},{"title":"Hosted Payment Pages (HPP) API","description":"Our low-code option to take payments securely at the lowest PCI compliance level - SAQ A.","includeFiles":["products/hosted-payment-pages/@v1/**/*"],"excludeFiles":[]},{"title":"Money Transfers API","description":"Money Transfer OCTs (Original Credit Transaction) allow funds to be pushed to an eligible card in 30 minutes or less.","includeFiles":["products/money-transfers/@v1/**/*"],"excludeFiles":[]},{"title":"Parties API","description":"Create parties, manage your payout instruments and beneficial owners and carry out identity verification checks.","includeFiles":["products/parties/@20250101/**/*"],"excludeFiles":[]},{"title":"SCA Exemptions API","description":"Maximize a frictionless checkout experience by using issuer data insights to apply exemptions.","includeFiles":["products/sca-exemptions/@v1/**/*"],"excludeFiles":[]},{"title":"Split Payments API","description":"Divide funds from a single payment amongst yourself and your parties/sellers.","includeFiles":["products/split-payments/@20250625/**/*"],"excludeFiles":[]},{"title":"Statements API","description":"Retrieve your account statement and see individual entries for all credits and debits.","includeFiles":["products/statements/@20250101/**/*"],"excludeFiles":[]},{"title":"Transfers API","description":"Transfer funds from source account to target account.","includeFiles":["products/transfers/@20250101/**/*"],"excludeFiles":[]},{"title":"Verified Tokens API","description":"Verified Tokens ensures that your customer's payment details are valid and CIT compliant when creating a token.","includeFiles":["products/verified-tokens/@v3/**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Last updated"]},": 12 May 2025 | ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/changelog/"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Change log"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"create-a-network-token","__idx":0},"children":["Create a network token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a network token via card schemes to replace your customer's sensitive card information. Use network tokens to improve payment authorization rates, gain built-in account updater and minimize fraud."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Supported schemes: Visa, Mastercard, American Express and Discover"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-network-token-request","__idx":1},"children":["Create a network token request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a network token:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," your request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokens:networkToken"]}," request link."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-network-token-example-request","__idx":2},"children":["Create a network token example request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]},"  ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/tokens/network"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Network token creation request body:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Card","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/create-network-token-front-request.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"paymentInstrument\": {\n    \"cardHolderName\": \"name\",\n    \"type\": \"card/front\",\n    \"cardExpiryDate\": {\n      \"month\": 1,\n      \"year\": 2030\n    },\n    \"cardNumber\": \"4444333322221111\"\n  },\n  \"merchant\": {\n    \"entity\": \"default\"\n  }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/create-network-token-tokenized-request.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"merchant\" : {\n    \"entity\": \"default\"\n  },\n  \"paymentInstrument\": {\n    \"type\": \"card/tokenized\",\n    \"href\": \"https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoia0gvT2xpdDV3WnpOZG1GTWpwemtXckVkRHdJSjFNQzR5VkE5NHhYUldzYz0ifQ\"\n  }\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Description of your network token creation request parameters:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains information about your merchant account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.entity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifies merchant account for billing, reporting and reconciliation. Contact your Worldpay Implementation Manager for more details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains the card details and token href."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An identifier for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}," being used. ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["type : ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/front"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["type : ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/tokenized"]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardHolderName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your customer's card name. This field can only be supplied with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/front"]}," payment instrument."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardExpiryDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's card expiry date. This field can only be supplied with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/front"]}," payment instrument."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your customer's 16 digit card number. This field can only be supplied with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/front"]}," payment instrument."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.href"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A link to your token. This field can only be supplied with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/tokenized"]}," payment instrument."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"responses","__idx":3},"children":["Responses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The majority of network token requests will include the network token in the response. These are referred to as synchronous network token creations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a synchronous network token creation, you receive:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an HTTP code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenReference"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenPaymentInstrument"]}," object which contains network ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenNumber"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["links to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/query-network-tokens-and-provision-cryptograms#network-token-inquiry"},"children":["query a network token"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/query-network-tokens-and-provision-cryptograms#provision-network-token-cryptograms"},"children":["provision a network token cryptogram"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For an asynchronous network token creation, you receive:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an HTTP code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenReference"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["link to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/query-network-tokens-and-provision-cryptograms#network-token-inquiry"},"children":["query a network token"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information about provisioning errors, please see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/network-token-errors"},"children":["Network token error responses"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-response","__idx":4},"children":["Example response"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"With network token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/create-network-token-sync-response.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"tokenReference\": \"aa224320-425c-40b6-9781-2cb7df76b0c8\",\n  \"paymentInstrument\": {\n    \"type\": \"card/masked\",\n    \"firstSix\": \"444433\",\n    \"lastFour\": \"1111\",\n    \"cardExpiryDate\": {\n      \"month\": 1,\n      \"year\": 2030\n    },\n    \"paymentAccountReference\": \"Q1HJZ28RKA1EBL470G9XYG90R5D3E\"\n  },\n  \"tokenPaymentInstrument\": {\n    \"status\": \"Active\",\n    \"type\": \"card/networkToken\",\n    \"tokenNumber\": \"4917610000000000\",\n    \"expiryDate\": {\n      \"month\": 3,\n      \"year\": 2030\n    }\n  },\n  \"_links\": {\n    \"self\": {\n      \"href\": \"https://try.access.worldpay.com/tokens/network\"\n    },\n    \"tokens:networkTokenLookup\": {\n      \"href\": \"https://try.access.worldpay.com/tokens/network/aa224320-425c-40b6-9781-2cb7df76b0c8\"\n    },\n    \"tokens:networkTokenCryptogram\": {\n      \"href\": \"https://try.access.worldpay.com/tokens/network/cryptograms\"\n    },\n    \"curies\": [\n      {\n        \"href\": \"https://try.access.worldpay.com/rels/tokens/{rel}.json\",\n        \"name\": \"tokens\",\n        \"templated\": true\n      }\n    ]\n  }\n}\n\n\n\n\n\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Without network token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/create-network-token-async-response.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"tokenReference\": \"aa224320-425c-40b6-9781-2cb7df76b0c8\",\n  \"paymentInstrument\": {\n    \"type\": \"card/masked\",\n    \"firstSix\": \"444433\",\n    \"lastFour\": \"1111\",\n    \"cardExpiryDate\": {\n      \"month\": 1,\n      \"year\": 2030\n    },\n    \"paymentAccountReference\": \"Q1HJZ28RKA1EBL470G9XYG90R5D3E\"\n  },\n  \"_links\": {\n    \"self\": {\n      \"href\": \"https://try.access.worldpay.com/tokens/network\"\n    },\n    \"tokens:networkTokenLookup\": {\n      \"href\": \"https://try.access.worldpay.com/tokens/network/aa224320-425c-40b6-9781-2cb7df76b0c8\"\n    },\n    \"curies\": [\n      {\n        \"href\": \"https://try.access.worldpay.com/rels/tokens/{rel}.json\",\n        \"name\": \"tokens\",\n        \"templated\": true\n      }\n    ]\n  }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Provisioning error","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/create-network-token-sync-response-provision-error.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"paymentInstrument\":{\n    \"type\":\"card/masked\",\n    \"firstSix\":\"555544\",\n    \"lastFour\":\"4444\",\n    \"cardExpiryDate\":{\n      \"month\":5,\n      \"year\":2035\n    },\n    \"paymentAccountReference\":\"900999AB1N1T9G3ABC0XYZ3HVY4AW\"\n  },\n  \"provisioningErrors\":[\n    {\n      \"errorCode\":\"301\",\n      \"providerErrorCode\":\"DECLINED\",\n      \"source\":\"A2T Mastercard NPT Token Provider Service\",\n      \"context\":\"Provision Token.Processor Error\",\n      \"message\":\"Provider error occurred : DECLINED\"\n    }\n  ],\n  \"_links\":{}\n}\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenReference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A reference to get the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenNumber"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokens:networkTokenLookup"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains the payment ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," and details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An identifier for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}," being used, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/masked"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.firstSix"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["First six digits of your customer's card number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.lastFour"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Last four digits of your customer's card number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardExpiryDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's card expiry date."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.paymentAccountReference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment account reference (PAR) is a non-financial reference that uniquely identifies the underlying cardholder account. This allows you to correlate payments made from the same account with differing instruments (e.g. cards, network tokens, and wallets), where the same account funds the transaction. A PAR cannot be used to initiate a payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenPaymentInstrument"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains the details of the network token created."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenPaymentInstrument.status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Active"]}," - The token is valid and ready for use in transactions."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Suspended"]},"- The token is temporarily suspended, meaning you can't use it until it's reactivated (often due to fraud concerns or other security issues). If the card is reactivated, then the status would automatically change to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Active"]},"."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Deleted"]}," - The token has been permanently deleted and you can no longer use it to take a payment. This could happen if the associated card is canceled or replaced."]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Expired"]}," - The token has passed its expiration date and is no longer valid for use. This should not occur often as token expiries are automatically extended when cards are extended."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenPaymentInstrument.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Should always be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/networkToken"]}," to indicate that this is a network token."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenPaymentInstrument.tokenNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A network token with the same length as the card number it masks."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenPaymentInstrument.expiryDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Expiry date of the network token. This value is likely different to the expiry date of the underlying card that corresponds to the network token (found in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardExpiryDate"]},"). Include this value where you use this token in payment authorization requests."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenPaymentInstrument.expiryDate.month"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Expiry month of the network token."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenPaymentInstrument.expiryDate.year"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Expiry year of the network token."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisioningErrors.errorCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Worldpay's representation of the error code."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisioningErrors.providerErrorCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The error code returned from the card schemes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisioningErrors.source"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Where the error occurred."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisioningErrors.context"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Context of the error."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provisioningErrors.message"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Greater description of the error."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next steps"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/query-network-tokens-and-provision-cryptograms#network-token-inquiry"},"children":["Query a network token"]}," or ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/query-network-tokens-and-provision-cryptograms#provision-network-token-cryptograms"},"children":["Provision a network token cryptogram"]}," or ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/query-network-tokens-and-provision-cryptograms#delete-network-tokens"},"children":["Delete a network token"]}]}]},"headings":[{"value":"Create a network token","id":"create-a-network-token","depth":1},{"value":"Create a network token request","id":"create-a-network-token-request","depth":2},{"value":"Create a network token example request","id":"create-a-network-token-example-request","depth":3},{"value":"Responses","id":"responses","depth":3},{"value":"Example response","id":"example-response","depth":4}],"frontmatter":{"seo":{"title":"Create a network token"}},"lastModified":"2026-06-29T14:10:07.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/tokens/create-a-network-token","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}