Last Updated: 23 April 2025 | Change Log
Querying Network Tokens and Provisioning Cryptograms
Proceed to network token inquiry if you do not receive a network token, else proceed to provisioning a cryptogram.
Network token inquiry
If you do not receive a tokenNumber
, send a GET
request to the tokens:networkTokenLookup
action link returned in the response of your create a network token request
Network token inquiry request
GET
https://try.access.worldpay.com/tokens/network/E9026BB9-0FD3-47C9-A088-17A68BF07659
No request body is needed for this request.
Response
The response status is 200 OK
. You receive links to your next available actions in your response. Please note, this API will always return token and card details associated with the token when it was created. These may become out of date over time.
{
"tokenPaymentInstrument": {
"status": "Active",
"type": "card/networkToken",
"tokenNumber": "4111111111111111",
"expiryDate": {
"month": 12,
"year": 2025
}
},
"paymentInstrument": {
"type": "card/masked",
"firstSix": "411111",
"lastFour": "1111",
"cardExpiryDate": {
"month": 12,
"year": 2025
},
"paymentAccountReference": "41111111111111111111111111111"
},
"_links": {
"self": {
"href": "https://try.access.worldpay.com/tokens/network/0b56de37-22b3-4422-a791-ae9550df1db0"
},
"tokens:networkTokenCryptogram": {
"href": "https://try.access.worldpay.com/tokens/network/cryptograms"
},
"curies": [
{
"href": "https://try.access.worldpay.com/rels/tokens/{rel}.json",
"name": "tokens",
"templated": true
}
]
}
}
Parameter | Description |
---|---|
tokenPaymentInstrument | An object that contains the network token details. |
tokenPaymentInstrument.status |
|
tokenPaymentInstrument.type | Should always be card/networkToken to indicate that this is a network token. |
tokenPaymentInstrument.tokenNumber | A network token with the same length as the card number it masks. |
tokenPaymentInstrument.expiryDate | Expiry date of the network token. |
tokenPaymentInstrument.expiryDate.month | Expiry month of the network token. |
tokenPaymentInstrument.expiryDate.year | Expiry year of the network token. |
paymentInstrument | An object that contains the payment card details. |
paymentInstrument.firstSix | First six digits of your customer's card number. |
paymentInstrument.lastFour | Last four digits of your customer's card number. |
paymentInstrument.cardExpiryDate | An object that contains your customer's card expiry date. |
paymentInstrument.cardExpiryDate.month | Card expiry month. |
paymentInstrument.cardExpiryDate.year | Card expiry year. |
tokenPaymentInstrument.paymentAccountReference | Also known as PAR, an alphanumeric value up to 29 characters used to link a Payment Account (PAN) to a token associated with it. |
Provisioning network token cryptograms
Once you receive the tokenNumber
, provision a cryptogram to take a card on file payment. A cryptogram contains transaction specific information.
Cryptograms are single use and valid for 24 hours.
To provision a network token cryptogram , POST
your request to the tokens:networkTokenCryptogram
action link. POST
https://try.access.worldpay.com/tokens/network/cryptograms
Request
{
"tokenNumber": "4111111111111111"
}
Parameter | Required | Description |
---|---|---|
tokenNumber | ✅ | 16 digits network token number provisioned via card schemes. |
Response
{
"cryptogramDetails": {
"cryptogram": "AgAAAAAASFh+gDRt/rq8QOkAAAA=",
"eci": "07"
},
"_links": {
"self": {
"href": "https://try.access.worldpay.com/tokens/network/cryptograms"
},
"tokens:networkTokenLookup": {
"href": "https://try.access.worldpay.com/tokens/network/{tokenReference}",
"templated": true
},
"curies": [
{
"href": "https://try.access.worldpay.com/rels/tokens/{rel}.json",
"name": "tokens",
"templated": true
}
]
}
}
Parameter | Description |
---|---|
cryptogramDetails | Contains the details of the new cryptogram. |
cryptogramDetails.cryptogram | The value for the cryptogram. Depending on the type of network token used, you can expect to receive a cryptogram in one of the following formats:
|
cryptogramDetails.eci | Electronic Commerce Indicator (ECI). Indicates the outcome of the cryptogram provisioning. Possible values:
|
You can use the network tokens created with Access Worldpay across other providers or gateways.
Deleting network tokens
To delete a network token, send a DELETE
request to the token resource with tokenNumber received in the tokenPaymentInstrument
object in your create a network token response.
You might want to delete tokens if a customer has closed their account with you, or if the customer no longer wants their card details kept on file.
Request
DELETE
https://try.access.worldpay.com/tokens/network/4111111111111111
No request body is needed for this request. You can delete tokens of all types.
Response
The response status is 204 No Content
.
Next steps