{
"errorDetails": {
"reason": "CardEligibilityError",
"message": "This card is not eligible for network tokenization."
}
}
details array containing field-level information, including a location (the camelCase property name that caused the error) and a message describing the issue. This information doesn’t contain PAN or cardholder data and is safe to surface to end users.
For example, a ValidationFailed error always includes details:
{
"errorDetails": {
"reason": "ValidationFailed",
"message": "Missing or invalid fields.",
"details": [
{
"location": "expirationDate.Year",
"message": "'Expiration Date Year' must be greater than 0"
}
]
}
}
HTTP Response Codes
What endpoint you call determines the types of HTTP response codes you can potentially receive. This table outlines the types of errors you can receive:API Error Details
| HTTP Response Code | errorDetails reason | errorDetails message | Recommended Action |
|---|---|---|---|
| 400 | InvalidProperty | A property validation check has failed. | Re-submit your request after correcting the input |
| 400 | InvalidInput | The tokenization service could not find data linked with provided input. | Check your Token Reference Id or Asset UUID; if you can’t identify an issue, contact your Pagos Account Manager |
| 400 | InvalidRequest | The tokenization service could not validate the request. | Review the error JSON object for more details |
| 400 | UnavailableMerchantAccount | The merchant account is not available. | Contact your Pagos Account Manager |
| 400 | CardEligibilityError | The card is not eligible for network tokenization. | No further action required |
| 400 | InvalidPanReferenceFormat | The PAN reference format is invalid. | Contact your Pagos Account Manager |
| 400 | InvalidPanReference | The requested PAN could not be found. | Contact your Pagos Account Manager |
| 400 | InvalidTokenReferenceFormat | The token reference format is invalid. | Re-submit your request after correcting the input |
| 400 | InvalidMerchantStatus | The merchant account is in an invalid status for the requested operation. | Contact your Pagos Account Manager |
| 400 | NoActiveTokens | There are no active (not suspended) Tokens for the given Account PAN and consumer account. | Re-tokenize the PAN |
| 400 | InvalidAssetReference | The requested asset could not be found. | Re-submit your request after correcting the input |
| 400 | InvalidUuidFormat | The Uuid format is invalid. | Re-submit your request after correcting the input |
| 400 | InvalidPanFormat | The PAN format is invalid, or other data associated with the PAN was incorrect or entered incorrectly. | Re-submit your request after correcting the input |
| 400 | InvalidPan | The PAN is invalid. | Re-submit your request after correcting the input |
| 400 | InvalidTrid | The TRID is invalid. | Contact your Pagos Account Manager |
| 400 | InvalidTridNetwork | The TRID network is invalid. | Contact your Pagos Account Manager |
| 400 | InvalidPanNetwork | The PAN network is invalid. | Contact your Pagos Account Manager |
| 400 | InvalidPanExpiryFormat | The PAN expiry format is invalid. | Re-submit your request after correcting the input |
| 400 | InvalidPanExpiry | The PAN expiry is invalid. | Re-submit your request after correcting the input |
| 400 | InvalidTokenStatus | The current token's status doesn't support the requested operation. | Call /status to get Token’s current status |
| 400 | ProvisionDataExpired | The PAN information provided is considered stale. | No further action required |
| 400 | CardVerificationFailed | Invalid payment instrument or data associated with the payment instrument. | No further action required |
| 400 | InvalidParameter | Your request does not have valid set of parameters required to process the business function. | Re-submit your request after correcting the input |
| 400 | IssuerDeclined | Declined by Issuer. | No further action required |
| 400 | MerchantNotFound | Can't find the merchant with specified ID. | Contact your Pagos Account Manager |
| 400 | NetworkRateLimit | The network rate limit is exceeded. | Re-submit your request later |
| 400 | NoResponseFromIssuer | No response from issuer. | Re-submit your request later |
| 400 | OperationNotSupported | Operation not supported. | Contact your Pagos Account Manager |
| 400 | TridConflict | Cannot perform operation for this card for this merchant. | Contact your Pagos Account Manager |
| 400 | AsyncTaskNotReady | This task is not ready yet. | Re-submit your request later |
| 400 | ValidationFailed | Missing or invalid fields. | Re-submit your request after correcting the input |
| 400 | CardNotEligible | This card cannot be used for tokenization at this moment. | No further action required |
| 400 | CardNotAllowed | The requested action is not allowed for a given PAN. | No further action required |
| 400 | CardDeclined | This card is considered not eligible for tokenization at this time. | No further action required |
| 400 | CardExpired | Card expired. | No further action required |
| 400 | CardCancelled | Card is cancelled. | No further action required |
| 400 | CardMarketNotSupported | The market of the Card provided is not supported. | No further action required |
| 400 | CardCannotBeTokenized | The Card is ineligible for tokenization due to an ongoing issue such as fraud. | No further action required |
| 400 | UnauthorizedOperation | The Token Reference ID cannot have its status changed as the token has been deleted. | No further action required |
| 400 | IssuerNotSupported | The Issuer of the Card provided does not support provisioning for cards they issue. | No further action required |
| 400 | ProvisionNotAllowed | Further operations for this card are no longer allowed. | No further action required |
| 400 | UserLockedOutFromProvisioning | User is locked out from provisioning. | Contact your Pagos Account Manager |
| 409 | DuplicateRequest | The PAN has already been provisioned to the device or the same request is currently being processed. | No further action required |
| 401 | AuthenticationFailed | The tokenization service could not authenticate the request. | Re-submit your request with correct credentials |
| 404 | InvalidTokenReference | The requested token could not be found. | Contact your Pagos Account Manager if the problem persists |
| 404 | MetadataNotAvailable | The requested token's metadata is not available. | Re-submit your request with a valid Token Reference ID |
| 404 | AccountNotFound | Account not found. | Contact your Pagos Account Manager |
| 404 | AsyncTaskNotFound | Async task not found. | Re-submit your request with a valid task ID |
| 404 | BatchJobNotFound | Batch job was not found. | Re-submit your request with a valid Batch job ID |
| 400 | SystemError | A system error occurred. | Contact your Pagos Account Manager |
| 400 | NetworkError | The network cannot process the request. | Re-submit your request later; contact your Pagos Account Manager if the problem persists |
| 500 | InternalServerError | Contact Pagos, include the requestId with communications. | Re-submit your request later; contact your Pagos Account Manager with the requestId from the response body if the problem persists |
A 500 response indicates an unexpected internal error rather than a business-logic failure. It isn’t associated with any of the named error reasons above. If you receive one, contact your Pagos Account Manager and provide them with the
requestId value from the error response body.