# Versioning and change log

This log details any breaking and non-breaking API changes we have released for our Tokens service.

Prerequisite
Make yourself familiar with our [API principles](/access/products/reference/api-principles) to ensure a resilient integration.

## Versioning log

#### Version 3 (28 December 2021)

details
summary
Entity based billing
- header change to "Content-Type: application/vnd.worldpay.tokens-v3+json"
- You must now supply the new mandatory field `merchant.entity` in your [create token request](/access/products/tokens/create-a-token)


#### Version 2 (08 June 2020)

details
summary
Downstream cross service integration
- header change to "Content-Type: application/vnd.worldpay.tokens-v2+json"


## Change log (non-breaking changes)

#### Deleting Network Payment Tokens (NPTs) (23 April 2025)

details
summary
More details
You can now [delete NPTs](/access/products/tokens/querying-network-tokens-and-provisioning-cryptograms#deleting-network-tokens). A typical use case, why you might want to do this, is if your customer withdraws their consent to store their card details.

details
summary
2023
#### Added PAR support for Network Payment Tokens (NPTs) (18 May 2023)

details
summary
More details
We have now added `paymentAccountReference` (PAR) support for [NPTs](/access/products/tokens/querying-network-tokens-and-provisioning-cryptograms).

#### Increase allowed token updates (15 March 2023)

details
summary
More details
We have increased the number of updates you can make to a [token](/access/products/tokens/create-a-token) in a rolling 30 day period, from 10 updates to 50.

#### New fundingType field in Token response (08 March 2023)

details
summary
More details
You now receive a new `fundingType` field in your [token response](/access/products/tokens/create-a-token#responses) with possible values of:

ul
li
`debit`
li
`credit`
li
`unknown`
#### Extended expiry for tokens (all versions) (31 January 2023)

details
summary
More details
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.

#### Network tokens (v3) (06 January 2023)

details
summary
More details
- You can now create [network tokens and cryptograms](/access/products/tokens/create-a-network-token). These can be used in card on file sale payments.


You can also use these tokens across other service providers or payment gateways.

details
summary
2020
#### Card network token querying (v2) (01 September 2020)

details
summary
More details
- You can now [query](/access/products/tokens/querying-and-updating-tokens) a card network token


#### Additional elements in response (v2) (08 June 2020)

details
summary
More details
- we may now include `bin` and `brand` properties in our tokens response