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 (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.entityin 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 now create network tokens and cryptograms. These can be used in card on file sale payments.
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
binandbrandproperties in our tokens response