Versioning and Change log

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


Make yourself familiar with our API Principles to ensure a resilient integration.

Versioning log

Version 3 (12/28/2021)

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

Version 2 (06/08/2020)

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

Change log (Non-breaking changes)

Added PAR support for Network Tokens (05/18/2023)

More details

We have now added paymentAccountReference (PAR) support for network payment tokens.

Increase allowed token updates (03/15/2023)

More details

We have increased the number of updates you can make to a token in a rolling 30 day period, from 10 updates to 50.

New fundingType field in Token response (03/08/2023)

More details

You now receive a new fundingType field in your token response with possible values of:

  • `debit`
  • `credit`
  • `unknown`

Extended expiry for tokens (all versions) (01/31/2023)

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) (01/06/2023)

More details

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

Card network token querying (v2) (09/01/2020)

More details
  • You can now query a card network token

Additional elements in response (v2) (06/08/2020)

More details
  • we may now include bin and brand properties in our tokens response