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.
- json
{
"error": "Invalid amount",
"message": {
"max_amount": "0.00"
},
"request-uuid": "a-unique-identifier-for-the-request"
}| Error | Explanation | Message | Extended Details* | HTTP Status Code |
|---|---|---|---|---|
| Cannot tokenize payment instrument | The payment instrument type does not support tokenization. | `payment_instrument_type`: the type of payment instrument | No | 400 |
| Card declined by issuer | Card verification failed. | None | No | 422 |
| Card is expired | Expired cards are unsupported. | None | No | 422 |
| Denied due to risk | Denied due to fraudulent behavior.Note: To prevent information disclosure, this reason should never be displayed to the customer. | None | No | 422 |
| Invalid amount | The specified `max_amount` was unsupported or invalid. | `max_amount`: The invalid value passed for the maximum amount | No | 422 |
| Invalid expire_at | The 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 cancelled | The 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. | None | No | 422 |
| PayPal payer restriction | The 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. | None | No | 422 |
| The provided payment instrument does not currently support tokenization with a cryptogram | Currently, only Visa cards are eligible for cryptograms. | None | No | 422 |
| Unsupported issuer | The issuer is based in an unsupported country, or does not support tokenization. | `issuer_country`: The ISO Alpha-2 country code of the issuer | No | 422 |
| Declined by Card Network | The request is declined by the network | Declined by Card Network | Yes | 422 |
| Ineligible by Card Network | PAN is NOT enabled for tokenization | Ineligible by Card Network | Yes | 422 |
| Invalid Card by Card Network | The provided card is invalid and declined by the network | Invalid Card by Card Network | Yes | 422 |
| Request Already in Progress | Same request is already in progress | Request Already in Progress | Yes | 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 | Yes | 422 |
| Token in Invalid State | The 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 State | Yes | 422 |
| Token Not Found | The 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 Found | Yes | 422 |
| Tokenization failed | An unhandled exception occurred. | None | Yes | 500 |
* Message may include additional additional details about failure
Test credit card numbers and nonces
The following credit card numbers can be used to trigger specific unsuccessful tokenization
responses in the sandbox environment.
| Error | Test Value | Card Type | Corresponding 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 tokenization
Triggering a mock PayPal rejection currently leverages max_amount for
parity with transaction processing.
| Error | Test Value |
|---|---|
| PayPal billing agreement cancelled | 2070.00 |
| PayPal payer restriction | 2075.00 |