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" 
}
ErrorExplanationMessageExtended Details*HTTP Status Code
Cannot tokenize payment instrumentThe payment instrument type does not support tokenization.`payment_instrument_type`: the type of payment instrumentNo400
Card declined by issuerCard verification failed.NoneNo
422
Card is expiredExpired cards are unsupported.NoneNo
422
Denied due to riskDenied due to fraudulent behavior.Note: To prevent information disclosure, this reason should never be displayed to the customer.NoneNo
422
Invalid amountThe specified `max_amount` was unsupported or invalid.`max_amount`: The invalid value passed for the maximum amountNo
422
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 No
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.NoneNo
422
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.NoneNo
422
The provided payment instrument does not currently support tokenization with a cryptogram Currently, only Visa cards are eligible for cryptograms.NoneNo
422
Unsupported issuerThe issuer is based in an unsupported country, or does not support tokenization.`issuer_country`: The ISO Alpha-2 country code of the issuerNo
422
Declined by Card NetworkThe request is declined by the networkDeclined by Card NetworkYes422
Ineligible by Card NetworkPAN is NOT enabled for tokenizationIneligible by Card NetworkYes422
Invalid Card by Card NetworkThe provided card is invalid and declined by the networkInvalid Card by Card NetworkYes422
Request Already in ProgressSame request is already in progressRequest Already in Progress
Yes422
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
Yes
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 StateYes
422
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 FoundYes422
Tokenization failedAn unhandled exception occurred.NoneYes500

* Message may include additional additional details about failure

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