{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/verified-tokens/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/verified-tokens/openapi"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"custom_product":"Verified Tokens","type":"markdown"},"seo":{"title":"Versioning and change log","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":"Heading","attributes":{"level":1,"id":"versioning-and-change-log","__idx":0},"children":["Versioning and change log"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This log details any breaking and non-breaking API changes we have released for our Verified Tokens service."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Prerequisite"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Make yourself familiar with our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/api-principles"},"children":["API principles"]}," to ensure a resilient integration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"versioning-log","__idx":1},"children":["Versioning log"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"version-3-18-august-2020","__idx":2},"children":["Version 3 (18 August 2020)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Additional card data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Version 3 was introduced to include card data in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/verified-tokens/create-verified-token"},"children":["Verified Tokens response"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"version-2-12-may-2020","__idx":3},"children":["Version 2 (12 May 2020)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Downstream cross service integration"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["no changes to our Verified Tokens API"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"change-log-non-breaking-changes","__idx":4},"children":["Change log (non-breaking changes)"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["2024"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"new-onetime-endpoint-all-versions-28-february-2024","__idx":5},"children":["New oneTime endpoint (all versions) (28 February 2024)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We have added a new ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/verified-tokens/create-verified-token"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oneTime"]}," endpoint"]},".  You can use this endpoint 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":"p","attributes":{},"children":["You can also use this, if you want to take a one-off payment. You must delete the token afterwards."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["2023"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"extended-expiry-for-tokens-all-versions-31-january-2023","__idx":6},"children":["Extended expiry for tokens (all versions) (31 January 2023)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The default expiry date/time of a token is 7 days in Try and 4 years in the Live environment. This expiry is extended by 7 days or 4 years after any use of the token, if under half of the time remains on the token."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["2022"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"additional-elements-for-not-verified-token-response-all-versions-08-march-2022","__idx":7},"children":["Additional elements for Not Verified Token response (all versions) (08 March 2022)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In version 3, we're now creating unverified token in case of account verification failure and return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}," as part of the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/verified-tokens/create-verified-token"},"children":["Not Verified Token response"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In version 2, we're now creating unverified token ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["href"]}," in case of account verification failure and return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}," as part of the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/verified-tokens/v2/create-verified-token"},"children":["Not Verified Token response"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In version 1, we're now creating unverified token ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["href"]}," in case of account verification failure as part of the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/verified-tokens/v1/create-verified-token"},"children":["Not Verified Token response"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["2021"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"optional-narrative-field-in-request-19-march-2021","__idx":8},"children":["Optional narrative field in request (19 March 2021)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now optionally send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["narrative"]}," as part of the Verified Tokens request."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Versioning and change log","id":"versioning-and-change-log","depth":1},{"value":"Versioning log","id":"versioning-log","depth":2},{"value":"Version 3 (18 August 2020)","id":"version-3-18-august-2020","depth":4},{"value":"Version 2 (12 May 2020)","id":"version-2-12-may-2020","depth":4},{"value":"Change log (non-breaking changes)","id":"change-log-non-breaking-changes","depth":2},{"value":"New oneTime endpoint (all versions) (28 February 2024)","id":"new-onetime-endpoint-all-versions-28-february-2024","depth":4},{"value":"Extended expiry for tokens (all versions) (31 January 2023)","id":"extended-expiry-for-tokens-all-versions-31-january-2023","depth":4},{"value":"Additional elements for Not Verified Token response (all versions) (08 March 2022)","id":"additional-elements-for-not-verified-token-response-all-versions-08-march-2022","depth":4},{"value":"Optional narrative field in request (19 March 2021)","id":"optional-narrative-field-in-request-19-march-2021","depth":4}],"frontmatter":{"seo":{"title":"Versioning and change log"}},"lastModified":"2025-12-11T15:08:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/verified-tokens/changelog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}