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.
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
Downstream cross service integration
- header change to "Content-Type: application/vnd.worldpay.tokens-v2+json"
More details
You can now delete NPTs.
A typical use case, why you might want to do this, is if your customer withdraws their consent to store their card details.
More details
We have now added paymentAccountReference
(PAR) support for NPTs.
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.
More details
You now receive a new fundingType
field in your token response with possible values of:
- `debit`
- `credit`
- `unknown`
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.
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.
More details
- You can now query a card network token
More details
- we may now include
bin
andbrand
properties in our tokens response