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 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) (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
andbrand
properties in our tokens response