Tokenization Errors

Availability
Use of the production Forward API is subject to eligibility.

Contact your Account Manager for more information or submit an inquiry to our Business Development team.
Tokenization errors are returned in the response body. The body is a JSON structure with a format resembling this example:
  1. json
{ 
    "error": "Invalid amount", 
    "message": { 
        "max_amount": "0.00" 
    }, 
    "request-uuid": "a-unique-identifier-for-the-request" 
}
ErrorExplanationMessageHTTP Status Code
Cannot tokenize payment instrumentThe payment instrument type does not support tokenization.`payment_instrument_type`: the type of payment instrument400
Card declined by issuerCard verification failed.None422
Card is expiredExpired cards are unsupported.None422
Denied due to riskDenied due to fraudulent behavior. Note: To prevent information disclosure, this reason should never be displayed to the customer. None422
Invalid amountThe specified `max_amount` was unsupported or invalid.`max_amount`: The invalid value passed for the maximum amount422
Invalid expire_atThe specified `expire_at` was in the past or invalid. `expire_at`: The invalid value passed for the datetime after which the tokenized PAN should be considered invalid 422
PayPal billing agreement cancelledThe customer requested a cancellation of all future transactions on their PayPal account. Reach out to the customer for more information or an alternative payment method.None422
PayPal payer restrictionThe customer's PayPal account can't be used for transactions at this time. The customer will need to contact PayPal for more information or use an alternative payment method.None422
The provided payment instrument does not currently support tokenization with a cryptogram Currently, only Visa cards are eligible for cryptograms.None422
Unsupported issuerThe issuer is based in an unsupported country, or does not support tokenization.`issuer_country`: The ISO Alpha-2 country code of the issuer422
Declined by Card NetworkThe request is declined by the networkDeclined by Card Network422
Ineligible by Card NetworkPAN is NOT enabled for tokenizationIneligible by Card Network422
Network Validation Error
 
The network returned an input validation error for the provided request
Network Validation Error
422
Invalid Card by Card NetworkThe provided card is invalid and declined by the networkInvalid Card by Card Network422
Invalid Format
The local field contains data in an invalid or unsupported format.
Invalid Format
422
Unable to Tokenize
The system was unable to tokenize the provided data. This may occur due to invalid input, unsupported data format, or an internal processing error.
Unable to Tokenize
422
Network Pan Not Enabled for Tokenization
The system was unable to tokenize the provided data.  This may occur due to invalid input, unsupported data format, or an internal processing error
Network Pan Not Enabled for Tokenization
422
Token in Invalid StateThe requested operatation cannont be performed because the token is in an invalid or inappropriate state.  This may occur if the token is expired, already used, revoked, or not yet activated.Token in Invalid State422
Token Not FoundThe specified token was not found or does not exist.  This may occur if the tokeni is invalid, expired, revoked, or was never issued.
Token Not Found422
Tokenization failedAn unhandled exception occurred.None500


Test credit card numbers and noncesAnchorIcon

The following credit card numbers can be used to trigger specific unsuccessful tokenization responses in the sandbox environment.
ErrorTest ValueCard TypeCorresponding Test Nonces
Card declined by issuer`4000111111111115`Visa`fake-processor-declined-visa-nonce`
`5105105105105100`Mastercard`fake-processor-declined-mastercard-nonce`
`378734493671000`American Express`fake-processor-declined-amex-nonce`
`6011000990139424`Discover`fake-processor-declined-discover-nonce`
`3566002020360505`JCB`fake-processor-failure-jcb-nonce`
Denied due to risk`4000111111111511`Visa`fake-gateway-rejected-fraud-nonce`
Unsupported issuer`3530111333300000`JCB`fake-valid-jcb-nonce`

Negative testing with PayPal tokenizationAnchorIcon

Triggering a mock PayPal rejection currently leverages max_amount for parity with transaction processing.
ErrorTest Value
PayPal billing agreement cancelled2070.00
PayPal payer restriction2075.00