Network token provisioning codes
Last updated: October 7, 2025
View Mastercard and Visa card scheme responses to a network token provisioning request.
The following table documents errors related to network token provisioning requests using Mastercard Digital Enablement Service (MDES).
Error Code | Description |
---|---|
| The issuer did not respond to the network message in the expected time. When this happens, Mastercard sends an asynchronous message to the issuer. You should only retry the request after the time specified in the |
| MDES had an internal exception. |
| The Primary Account Number (PAN) format is not valid, or other data associated with the PAN was incorrect or entered incorrectly. Ask your customer to verify their details and try again. |
| The required expiry date for the card is missing. Retry the request providing the card's expiry date. |
| The PAN was already provisioned to the device or the same request is being processed. |
| The provisioning of PAN to the device failed. |
| The PAN is not in an approved account range for MDES. |
| The device is not supported by MDES. |
| The issuer does not allow the PAN to be provisioned to the device. |
| The PAN was already provisioned to the maximum number of allowed devices. |
| The eligibility receipt is expired or the value cannot be found. |
| The task ID could not be found. For inbound calls, the task ID was not unique. |
| The terms and conditions ID accepted by the account holder does not match what was sent in the |
| The authentication method could not be found. |
| The Token Unique Reference (TUR) could not be found, or does not match the provided |
| The PAN unique reference could not be found. |
| The token is in an invalid status for the requested operation. For example, you may be attempting to reactivate a deleted token. |
| The operation requested is invalid for the token. For example, you may be attempting to activate an approved mapping, or you've provided |
| The PIX value in the Application Identifier (AID) was not correct for the account range brand product. |
| The Registered Identification Number (RID) value in the AID is incorrect for Mastercard. |
| The cardlet ID could not be mapped to a cardlet. |
| The URI for the call cannot be mapped to an API endpoint. |
| The provided Tokenization Authentication Value (TAV) is incorrect and was rejected. |
| The authentication code is expired or invalid. |
| The data supplied for the request is invalid. No further details are provided. |
| There are no active tokens for the given account PAN and consumer account. |
| You reached the maximum amount of alternate payment credentials for the token. You can either:
|
| The credentials were already used in a transaction, or the validity period of the alternate payment account credentials expired. This error is also returned if the cryptogram has been exchanged but the value for |
| The token PAN that was supplied in the request was not found. This could be due to:
|
| The financial account does not have an associated account range in MDES. |
| The push account receipt is not found or is not valid for the token requestor. |
| The number of allowed re-digitizations for the token in the given time period exceeded the maximum value. |
The following table documents errors related to network token provisioning requests using Visa Token Service (VTS).
VTS exposes different APIs. Any VTS API returns these errors, so you should handle them consistently. They are not documented as part of each individual API description.
Error code | Reason code | Description |
---|---|---|
|
| Invalid payment instrument or data associated with the payment instrument. The Ask your customer to check that all information is entered correctly. |
|
| Visa cannot validate this card. Provision using a different method. |
|
| The purpose of the token does not match the intended usage of the token. Refer to VTS API specification to check the expected usage of the token. |
|
| The card cannot be used for tokenization at this moment. Try again later or choose another Visa card. |
Error code | Reason code | Description |
---|---|---|
|
| The requested action is not allowed for the given PAN. The card is valid but cannot be used for tokenization. This is most likely due to a reason specific to Visa. Ask the customer to use a different card. |
|
| The card is not eligible for tokenization at this moment. Try to provision the token one more time. If the issue persists, ask the customer to either use a different card, or to contact their issuer. |
Error code | Reason code | Description |
---|---|---|
|
| Magnetic Stripe Reader (MSR) presentation is not supported for this PAN. Remove this presentation type and try again. |
|
| The PAN information provided is considered stale. If your are managing a push provisioning flow which allows the user to choose a card from their banking application or a web page, ask your customer to select the card again. If you are sending the PAN in the |
|
| Card metadata is stale. Request the latest card metadata and try again. |
|
| Further operations for this card are no longer allowed. Contact your bank to resolve this issue. |
Error code | Reason code | Description |
---|---|---|
|
| The requested action is not allowed for the given primary account number (PAN). The card is valid but cannot be used for tokenization. This is most likely due to reasons specific to Visa. Ask the customer to use a different card. |
|
| The card is not eligible for tokenization at this moment. Try to provision the token one more time. If the issue persists, ask the customer to either use a different card, or to contact their issuer. |
|
| Further operations for this card are not allowed. Contact your bank to resolve the issue. |
Error code | Reason code | Description |
---|---|---|
|
| Further operations for this card are not allowed. Contact your bank to resolve the issue. |