Last updated: 12 May 2025 | Change log
The API reference for our Tokens service lists typical error responses returned where an attempt to create a network token has failed. This page gives a fuller overview of network token error responses, returned either by our service or from the card schemes.
These are errors returned by our service upon failed attempts to create network tokens. For more generic information on Worldpay errors, see Worldpay error responses.
Error example:
{
"errorName": "bodyDoesNotMatchSchema",
"message": "The json body provided does not match the expected schema",
"validationErrors": [
{
"errorName": "fieldHasInvalidValue",
"message": "Card expiry date must not be in the past",
"jsonPath": "$.paymentInstrument.cardExpiryDate"
}
]
}Full list:
| HTTP status | Error name | Error message | Validation error name | Validation error message | Validation error json path | Merchant suggestion |
|---|---|---|---|---|---|---|
| 500 INTERNAL_ SERVER_ERROR | N/A | N/A | N/A | N/A | N/A | Retry |
| 400 BAD_REQUEST | bodyIsNotJson | The body within the request is not valid json | N/A | N/A | N/A | Correct request body |
| 400 BAD_REQUEST | bodyDoesNot MatchSchema | The json body provided does not match the expected schema | fieldHasInvalidValue | Couldn't determine type of paymentInstrument | $.paymentInstrument | Correct request body |
| 400 BAD_REQUEST | bodyDoesNot MatchSchema | The json body provided does not match the expected schema | fieldIsMissing | Card holder name must be supplied | $.paymentInstrument. cardHolderName | Correct request body |
| 400 BAD_REQUEST | bodyDoesNot MatchSchema | The json body provided does not match the expected schema | fieldHasInvalidValue / fieldIsMissing | Card expiry year must be supplied | $.paymentInstrument. cardExpiryDate.year | Correct request body |
| 400 BAD_REQUEST | bodyDoesNot MatchSchema | The json body provided does not match the expected schema | fieldHasInvalidValue / fieldIsMissing | Card expiry month must be supplied | $.paymentInstrument. cardExpiryDate.month | Correct request body |
| 400 BAD_REQUEST | bodyDoesNot MatchSchema | The json body provided does not match the expected schema | fieldHasInvalidValue | Card expiry date must not be in the past | $.paymentInstrument. cardExpiryDate | Correct request body |
| 403 FORBIDDEN | accessDenied | Access to the requested resource has been denied | N/A | N/A | N/A | Contact your account manager to board you for this service |
| 400 BAD_REQUEST | bodyDoesNot MatchSchema | The json body provided does not match the expected schema | panFailedLuhnCheck | Card number is not valid | $.paymentInstrument. cardNumber | Correct request body |
| 401 UNAUTHORIZED | accessDenied | Access to the requested resource has been denied | N/A | N/A | N/A | Contact your account manager to board you for this service |
| 404 NOT_FOUND | resourceNotFound | Requested resource was not found | N/A | N/A | N/A | Likely need to correct endpoint |
| 400 BAD_REQUEST | bodyDoesNot MatchSchema | The json body provided does not match the expected schema | fieldIsNotAllowed | The identified field is present when it is explicitly not allowed in the request | $.tokenReference | Correct request body |
| 400 BAD_REQUEST | bodyDoesNot MatchSchema | The json body provided does not match the expected schema | fieldIsNotAllowed | The identified field is present when it is explicitly not allowed in the request | $.paymentInstrument. firstSix | Correct request body |
These are errors from the card schemes and therefore we cannot guarantee that the list is complete. However, it does represent all errors returned in recent months.
All will have an HTTP status of 200.
Error example:
"provisioningErrors": [
{
"errorCode": "301",
"providerErrorCode": "403",
"source": "A2T Visa NPT Token Provider Service",
"context": "Provision Token.Processor Error",
"message": "Provider error occurred : Visa declined this transaction. If you see this too frequently, and you think you are getting this in error please contact the issuer."
},
{
"errorCode": "301",
"providerErrorCode": "FIS.A2T.NPT.TokenProvider.Visa.Core.Dto.Transport.Par.GetParResponseError",
"source": "A2T Visa NPT Token Provider Service",
"context": "Get PAR.Processor Error",
"message": "Provider error occurred : File maintenance error"
}
]Full list:
| errorCode | providerErrorCode | source | context | provisioningErrorMessage | Merchant suggestion |
|---|---|---|---|---|---|
| 301 | DECLINED | A2T Mastercard NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : DECLINED | Reject customer card |
| 301 | 400 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Input to tokenRequestorId is invalid | Contact account manager |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Visa declined this transaction. If you see this too frequently, and you think you are getting this in error please contact the issuer. | Reject customer card |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Further operations for this card are no longer allowed. Contact the bank to resolve this issue. | Reject customer card |
| 301 | PAN_INELIGIBLE | A2T Mastercard NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : PAN Ineligible | Reject customer card |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Your request does not have valid set of parameters required to process the business function. | Contact account manager |
| 301 | 301 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Visa declined this transaction. | Reject customer card |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Card Not Eligible | Reject customer card |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Further operations for this card are no longer allowed. Contact the issuer to resolve the issue. | Reject customer card |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : This card cannot be used at this moment. Please try again later, or choose another Visa card. | Reject customer card |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Further operations are no longer allowed. Please contact your bank to resolve the issue. | Reject customer card |
| 301 | ServiceUnavailable | A2T Mastercard NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : no description provided | Contact account manager |
| 301 | 400 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Input for encPaymentInstrument. paymentInstrument.name is invalid | Tell customer to change name |
| 301 | 400 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Your request does not have valid set of parameters required to process the business function. | Contact account manager |
| 301 | INVALID_PAN | A2T Mastercard NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Invalid PAN | Tell customer to correct PAN |
| 301 | PAN_INELIGIBLE | A2T Mastercard NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : PAN Ineligible | Contact account manager |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Input to encPaymentInstrument and encRiskData is invalid | Reject customer card |
| 301 | FIS.A2T.NPT.TokenProvider. Visa.Core.Dto.Transport. Par.GetParResponseError | A2T Visa NPT Token Provider Service | Get PAR.Processor Error | Provider error occurred : File maintenance error | Contact account manager |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : The requested action is not allowed for the given PAN. | Reject customer card |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Input for riskData was invalid | Contact account manager |
| 301 | 400 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Input to encPaymentInstrument and encRiskData is invalid. | Reject customer card |
| 301 | 400 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : The request is invalid. Some request parameters may have invalid format. | Contact account manager |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Please contact the bank to resolve the issue. | Reject customer card |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : This card type is not eligible. | Reject customer card |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Further operations for this card are no longer allowed. Please contact the bank to resolve the issue. | Reject customer card |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Conflicts with existing token, violates business rules. | Reject customer card |
| 301 | 400 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : The request is invalid. Some request parameters may have invalid format. | Reject customer card |
| 301 | INTERNAL_SERVICE_FAILURE | A2T Mastercard NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : The system had an internal exception | Retry |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Further operations are no longer allowed. Please contact your bank to resolve the issue. | Contact account manager |
| 301 | 400 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Unsupported token. | Contact account manager |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Your request does not have valid set of parameters required to process the business function. | Contact account manager |
| 301 | 400 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Input to encPaymentInstrument and/or encRiskData is invalid. | Reject customer card |
| 301 | PAN_INELIGIBLE | A2T Mastercard NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : PAN Ineligible | Contact account manager |
| 301 | INVALID_PAN | A2T Mastercard NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Invalid PAN | Contact account manager |
| 301 | DECLINED | A2T Mastercard NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : DECLINED | Contact account manager |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : Visa declined this transaction because this is a case of a duplicate request while another one is inflight. | Wait 5 minutes before retrying |
| 301 | 403 | A2T Visa NPT Token Provider Service | Provision Token.Processor Error | Provider error occurred : The maximum number of tokens has been exceeded for the given PAN. | Reject customer card |