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 to ensure a resilient integration.

Versioning log

Version 3 (28 December 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 (08 June 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 (18 May 2023)

More details

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


Increase allowed token updates (15 March 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 (08 March 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) (31 January 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) (06 January 2023)

More details

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


Card network token querying (v2) (01 September 2020)

More details
  • You can now query a card network token

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

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