{"templateId":"markdown","versions":[{"version":"v1","label":"v1","link":"/products/verified-tokens/v1/create-verified-token","default":false,"active":false,"folderId":"bc25eb53"},{"version":"v2","label":"v2","link":"/products/verified-tokens/v2/create-verified-token","default":false,"active":true,"folderId":"bc25eb53"},{"version":"v3","label":"v3","link":"/products/verified-tokens/create-verified-token","default":true,"active":false,"folderId":"bc25eb53"}],"sharedDataIds":{"sidebar":"sidebar-products/verified-tokens/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/verified-tokens/openapi"},"props":{"metadata":{"markdoc":{"tagList":["partial","admonition","tabs","tab","code-snippet"]},"custom_product":"Verified Tokens","type":"markdown"},"seo":{"title":"Create a verified 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"]},": 28 February 2024 | ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/verified-tokens/changelog/"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Change log"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"create-a-verified-token","__idx":0},"children":["Create a verified token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use our Verified Tokens API to verify your customer's payment details and create a verified token."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-a-verified-token-request","__idx":1},"children":["Create a verified token request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a verified token, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," your request to the:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifiedTokens:oneTime"]}," action link - Use this action link:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["in all circumstances if PSD2 regulations apply to you (primarily if you are located in the UK, EEA, and Gibraltar). If you intend to keep the token for future payments, proceed to a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["challengeMandated"]}," 3DS flow to remain SCA compliant, before taking a payment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["if you want to take a one-off payment. You must delete the token afterwards."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifiedTokens:cardOnFile"]}," action link - Use this action link only if PSD2 regulations do ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," apply to you, and you intend to store cards for card on file or subscription payments."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you create a verified token, you can optionally include the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["namespace"]}," parameter in your request. Choose either of the ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Card with a namespace"]}," or ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Session with a namespace"]}," tabs below to see an example."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/create-a-token"},"children":["create a token"]}," for more information about namespaces."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/verifiedTokens/oneTime"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["or"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/verifiedTokens/cardOnFile"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verified 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-verified-token-submission.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"description\": \"Token-Description\",\n  \"paymentInstrument\": {\n    \"type\": \"card/plain\",\n    \"cardHolderName\": \"Sherlock Holmes\",\n    \"cardNumber\": \"4444333322221111\",\n    \"cardExpiryDate\": {\n      \"month\": 5,\n      \"year\": 2035\n    },\n    \"cvc\": \"123\",\n    \"billingAddress\": {\n      \"address1\": \"221B Baker Street\",\n      \"address2\": \"Marylebone\",\n      \"address3\": \"Westminster\",\n      \"postalCode\": \"NW1 6XE\",\n      \"city\": \"London\",\n      \"state\": \"Greater London\",\n      \"countryCode\": \"GB\"\n    }\n  },\n  \"merchant\": {\n    \"entity\": \"default\"\n  },\n  \"verificationCurrency\": \"GBP\"\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Card with a namespace","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/create-verified-token-with-namespace-submission.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"description\": \"Token-Description\",\n  \"paymentInstrument\": {\n    \"type\": \"card/plain\",\n    \"cardHolderName\": \"Sherlock Holmes\",\n    \"cardNumber\": \"4444333322221111\",\n    \"cardExpiryDate\": {\n      \"month\": 5,\n      \"year\": 2035\n    },\n    \"cvc\": \"123\",\n    \"billingAddress\": {\n      \"address1\": \"221B Baker Street\",\n      \"address2\": \"Marylebone\",\n      \"address3\": \"Westminster\",\n      \"postalCode\": \"NW1 6XE\",\n      \"city\": \"London\",\n      \"state\": \"Greater London\",\n      \"countryCode\": \"GB\"\n    }\n  },\n  \"merchant\": {\n    \"entity\": \"default\"\n  },\n  \"verificationCurrency\": \"GBP\",\n  \"namespace\": \"SHOPPER_ID_1234567890\"\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"sessionState","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/create-verified-token-session-submission.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"description\": \"Token-Description\",\n  \"paymentInstrument\": {\n    \"type\": \"card/checkout\",\n    \"cardHolderName\": \"Sherlock Holmes\",\n    \"sessionHref\": \"https://try.access.worldpay.com/verifiedTokens/sessions/eyJrIjoxLCJkIjoiZmJIT1pOOXNRc2xFeWQ1NXc5WEVLWHppUlJUWkpiMGozZkZIdWhFdmp4QTd4UmpNcWVmL0xJQzhHUTE0MCt6NyJ9\",\n    \"billingAddress\": {\n      \"address1\": \"221B Baker Street\",\n      \"address2\": \"Marylebone\",\n      \"address3\": \"Westminster\",\n      \"postalCode\": \"NW1 6XE\",\n      \"city\": \"London\",\n      \"state\": \"Greater London\",\n      \"countryCode\": \"GB\"\n    }\n  },\n  \"merchant\": {\n    \"entity\": \"default\"\n  },\n  \"verificationCurrency\": \"GBP\"\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"sessionState with a namespace","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/create-verified-token-session-with-namespace-submission.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"description\": \"Token-Description\",\n  \"paymentInstrument\": {\n    \"type\": \"card/checkout\",\n    \"cardHolderName\": \"Sherlock Holmes\",\n    \"sessionHref\": \"https://try.access.worldpay.com/verifiedTokens/sessions/eyJrIjoxLCJkIjoiZmJIT1pOOXNRc2xFeWQ1NXc5WEVLWHppUlJUWkpiMGozZkZIdWhFdmp4QTd4UmpNcWVmL0xJQzhHUTE0MCt6NyJ9\",\n    \"billingAddress\": {\n      \"address1\": \"221B Baker Street\",\n      \"address2\": \"Marylebone\",\n      \"address3\": \"Westminster\",\n      \"postalCode\": \"NW1 6XE\",\n      \"city\": \"London\",\n      \"state\": \"Greater London\",\n      \"countryCode\": \"GB\"\n    }\n  },\n  \"merchant\": {\n    \"entity\": \"default\"\n  },\n  \"verificationCurrency\": \"GBP\",\n  \"namespace\": \"SHOPPER_ID_1234567890\"\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Description of your 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":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A description of your token. If not supplied, a default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}," is created for you."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tokenExpiryDateTime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The date/time after which the token will be unavailable, expressed in ISO 8601 format. If not supplied, a default expiry date/time is used."]}]},{"$$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 payment type and details. All sub-fields are mandatory with the exception of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvc"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingAddress"]}," (see below)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The CVC number from the card. This is used during the verification process and if not supplied, the verification acceptance rate is likely to be lower."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingAddress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object containing the billing address information.  ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If included, the below fields are mandatory:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address1"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["countryCode"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postalCode"]}]}]}," This is used during the verification and payment processes. If the address supplied does not match the address registered with the issuing bank, the payment carries additional risk."]}]},{"$$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 the merchant. Contact your Worldpay Implementation Manager for more information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verificationCurrency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The 3 character currency code. See our list of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/supported-countries-currencies#iso-currency-codes"},"children":["supported currencies"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["namespace"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A namespace is used to group up to 16 cards, e.g. for one customer. A card can exist in more than one namespace."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"using-a-session","__idx":2},"children":["Using a session"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/checkout"},"children":["Access Checkout SDK"]},", the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.type"]}," changes from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/plain"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/checkout"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sessionHref"]}," is used instead of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardNumber"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardExpiryDate"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvc"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sessionHref"]}," looks like this :"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://try.access.worldpay.com/verifiedTokens/sessions/eyJrIjoxLCJkIjoicGtubGtlWDJzeTVTdG1Qa3F5WlZ0emdJY1JEbjIyZVJ6KzlOR245YWlOMFVsVytCYitTa1NWa3l0RU1DQjZXYiJ9\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":["The session has a lifespan of one minute and can be used only once."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"responses","__idx":3},"children":["Responses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you've sent your request, one of the following responses is returned:"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Verified"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your Verified Token request was successful, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]}," of verification and one of the following response codes is returned:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201 Created"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 Conflict"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information about these response codes, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/create-a-token#create-a-token-responses"},"children":["Create a token responses"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains links to the:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v5/verifications"},"children":["verification"]}," result"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/query-and-update-tokens"},"children":["token"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/create-verified-token-response.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"outcome\": \"verified\",\n  \"_links\": {\n    \"verifications:verification\": {\n      \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n    },\n    \"tokens:token\": {\n      \"href\": \"https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoiNjd5bnJnSTR3a3FITW00SHNjaE90YnAwcVlvZ1pSZ3RFOXJjcklzVzY1ND0ifQ\"\n    },\n    \"curies\": [\n      {\n        \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}.json\",\n        \"name\": \"verifications\",\n        \"templated\": true\n      },\n      {\n        \"href\": \"https://try.access.worldpay.com/rels/tokens/{rel}.json\",\n        \"name\": \"tokens\",\n        \"templated\": true\n      }\n    ]\n  }\n}"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v5/verifications#query-verifications-request"},"children":["query your verification"]}," to get your next available payment actions links."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/verifications/accounts/{resource}"]}]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Not verified"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the verification failed, a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["206 Partial Content"]}," HTTP response status code is returned. The response body contains a link to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v5/verifications"},"children":["verification"]}," result as an unverified token is created."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/create-verified-token-not-verified-response.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"outcome\": \"not verified\",\n  \"code\": \"106\",\n  \"description\": \"INVALID ACCOUNT\",\n  \"_links\": {\n    \"verifications:verification\": {\n      \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n    },\n    \"tokens:token\": {\n      \"href\": \"https://try.access.worldpay.com/tokens/eyJrIjoxLCJkIjoiNjd5bnJnSTR3a3FITW00SHNjaE90YnAwcVlvZ1pSZ3RFOXJjcklzVzY1ND0ifQ\"\n    },\n    \"curies\": [\n      {\n        \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}.json\",\n        \"name\": \"verifications\",\n        \"templated\": true\n      },\n      {\n        \"href\": \"https://try.access.worldpay.com/rels/tokens/{rel}.json\",\n        \"name\": \"tokens\",\n        \"templated\": true\n      }\n    ]\n  }\n}"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are getting an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"outcome\": \"not verified\""]},", the next logical step is to ask your customer to re-enter, try a different or supply a new card. You can then try and verify the token again."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You might receive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"code\": \"65\""]}," for an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"outcome\": \"not verified\""]}," . The most likely reason is that the card issuer wants to authenticate the customer before verifying the token. In this case, we create an unverified token and suggest that you proceed to authenticate with our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds"},"children":["3DS API"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you then want to take a one-time payment straight away, proceed directly to our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6"},"children":["Payments API"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you want to use the unverified token in a recurring capacity (e.g. instalment or subscription), proceed to our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v5/verifications"},"children":["Verifications API"]}," to verify the token separately. You can then store your verified token for future use or use it immediately."]}]}]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$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/card-payments/v6/authorize-a-payment"},"children":["Take a payment"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-recurring-payment#recurring-authorization-without-verification"},"children":["Take your first and subsequent recurring payment"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-cardonfile-payment#card-on-file-without-verification-authorization-request"},"children":["Take your first and subsequent card on file payment"]}," - (use this as your next step if you have created a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sessionState"]},")"]}]},"headings":[{"value":"Create a verified token","id":"create-a-verified-token","depth":1},{"value":"Create a verified token request","id":"create-a-verified-token-request","depth":2},{"value":"Using a session","id":"using-a-session","depth":3},{"value":"Responses","id":"responses","depth":2}],"frontmatter":{"seo":{"title":"Create a verified token"}},"lastModified":"2026-05-13T07:59:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/verified-tokens/v2/create-verified-token","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}