{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/tokens/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/tokens/openapi"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"custom_product":"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 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-28-december-2021","__idx":2},"children":["Version 3 (28 December 2021)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Entity based billing"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["header change to \"Content-Type: application/vnd.worldpay.tokens-v3+json\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must now supply the new mandatory field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.entity"]}," in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/create-a-token"},"children":["create token request"]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"version-2-08-june-2020","__idx":3},"children":["Version 2 (08 June 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":["header change to \"Content-Type: application/vnd.worldpay.tokens-v2+json\""]}]}]},{"$$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":"Heading","attributes":{"level":4,"id":"detokenizing-12-may-2026","__idx":5},"children":["Detokenizing (12 May 2026)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/detokenize"},"children":["detokenize"]}," and retrieve the underlying card numbers stored within a token."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An example use case is if you are PCI-accredited and migrating a token or tokens, either to another provider or internally."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Detokenizing exposes your business to high levels of PCI auditing, required to remain PCI compliant."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"deleting-network-payment-tokens-npts-23-april-2025","__idx":6},"children":["Deleting Network Payment Tokens (NPTs) (23 April 2025)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can now ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/query-network-tokens-and-provision-cryptograms#delete-network-tokens"},"children":["delete NPTs"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," A typical use case, why you might want to do this, is if your customer withdraws their consent to store their card details."]}]},{"$$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":"added-par-support-for-network-payment-tokens-npts-18-may-2023","__idx":7},"children":["Added PAR support for Network Payment Tokens (NPTs) (18 May 2023)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We have now added ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentAccountReference"]}," (PAR) support for ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/query-network-tokens-and-provision-cryptograms"},"children":["NPTs"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"increase-allowed-token-updates-15-march-2023","__idx":8},"children":["Increase allowed token updates (15 March 2023)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We have increased the number of updates you can make to a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/create-a-token"},"children":["token"]}," in a rolling 30 day period, from 10 updates to 50."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"new-fundingtype-field-in-token-response-08-march-2023","__idx":9},"children":["New fundingType field in Token response (08 March 2023)"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["More details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You now receive a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fundingType"]}," field in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/create-a-token#responses"},"children":["token response"]}," with possible values of:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["`debit`"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["`credit`"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["`unknown`"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"extended-expiry-for-tokens-all-versions-31-january-2023","__idx":10},"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":"Heading","attributes":{"level":4,"id":"network-tokens-v3-06-january-2023","__idx":11},"children":["Network tokens (v3) (06 January 2023)"]},{"$$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":["You can now create ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/create-a-network-token"},"children":["network tokens and cryptograms"]},". These can be used in card on file sale payments."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can also use these tokens across other service providers or payment gateways."]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["2020"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"card-network-token-querying-v2-01-september-2020","__idx":12},"children":["Card network token querying (v2) (01 September 2020)"]},{"$$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":["You can now ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/tokens/query-and-update-tokens"},"children":["query"]}," a card network token"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"additional-elements-in-response-v2-08-june-2020","__idx":13},"children":["Additional elements in response (v2) (08 June 2020)"]},{"$$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":["we may now include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bin"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["brand"]}," properties in our tokens response"]}]}]}]},{"$$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 (28 December 2021)","id":"version-3-28-december-2021","depth":4},{"value":"Version 2 (08 June 2020)","id":"version-2-08-june-2020","depth":4},{"value":"Change log (non-breaking changes)","id":"change-log-non-breaking-changes","depth":2},{"value":"Detokenizing (12 May 2026)","id":"detokenizing-12-may-2026","depth":4},{"value":"Deleting Network Payment Tokens (NPTs) (23 April 2025)","id":"deleting-network-payment-tokens-npts-23-april-2025","depth":4},{"value":"Added PAR support for Network Payment Tokens (NPTs) (18 May 2023)","id":"added-par-support-for-network-payment-tokens-npts-18-may-2023","depth":4},{"value":"Increase allowed token updates (15 March 2023)","id":"increase-allowed-token-updates-15-march-2023","depth":4},{"value":"New fundingType field in Token response (08 March 2023)","id":"new-fundingtype-field-in-token-response-08-march-2023","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":"Network tokens (v3) (06 January 2023)","id":"network-tokens-v3-06-january-2023","depth":4},{"value":"Card network token querying (v2) (01 September 2020)","id":"card-network-token-querying-v2-01-september-2020","depth":4},{"value":"Additional elements in response (v2) (08 June 2020)","id":"additional-elements-in-response-v2-08-june-2020","depth":4}],"frontmatter":{"seo":{"title":"Versioning and change log"}},"lastModified":"2026-05-12T08:58:08.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/tokens/changelog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}