Appendix

For test cards, refer to Test card numbers.

HTTP Status Code Summary

Code number

Description

200

OK

400

Bad Request

401

Unauthorized

402

Request Failed

403

Forbidden

404

Not Found

409

Conflict

429

Too Many Requests

500, 502, 503, 504

Server Errors

Error codes from Clover Payment APIs

Code

Description

Request type

Message to buyer

amount_too_large

The amount provided exceeds the amount allowed by Clover ($999, 999.99).

Create charge and pay for order.

Transaction cannot be processed, please contact the merchant.

card_declined

The source provided was declined by the payment gateway.

Create charge and pay for order.

Transaction declined, please use a different card.

card_on_file_missing

The customer attempting to pay does not have a source on file to complete the payment.

Charge

Transaction failed, incorrect card data.

charge_already_captured

The charge provided has already been captured.

Capture charge

Transaction has already been captured.

charge_already_refunded

The charge provided has already been refunded.

Refund

Transaction has already been refunded.

email_invalid

The email provided is not valid.

Create charge, create, or update customer, pay for order.

Email ID is invalid, enter valid email ID and retry.

expired_card

The expiration date (the combination of card.exp_month and card.exp_year) provided is in the past.

Token

Card expired, enter valid card number and retry.

incorrect_cvc

The card.cvv provided is not a three- or four-digit value.

Token

CVV value is incorrect, enter correct CVV value and retry.

incorrect_number

The value provided in card.number is not valid.

Token

Card number is invalid, enter valid card number and retry.

invalid_card_type

The card.brand provided is not a recognized value.

Token

Card brand is invalid or not supported, please use valid card and retry.

invalid_charge_amount

The amount provided exceeds the amount allowed by Clover.

Charge

Invalid transaction amount, please contact merchant.

invalid_request

The value provided in card.number is not a valid raw or encrypted PAN.

Token

Card is invalid, please retry with a new card.

invalid_tip_amount

The tip_amount provided is not a valid amount.

Create charge and pay for order.

Invalid tip amount, please correct and retry.

invalid_tax_amount

The tax_amount provided is not a valid amount.

Create charge

Incorrect tax amount, please correct and retry.

Missing

The token request failed upstream, and the upstream message could not be processed.

Token

Unable to process transaction.

order_already_paid

The order identified by the ID in the request URL has already been paid.

Pay order

Order already paid.

processing_error

A generic error indicating that the request could not be processed as submitted.

Any

Transaction could not be processed.

rate_limit

Your application made too many requests and additional requests will not be processed until the rate limit expires.

Any

Transaction could not be processed, please contact the merchant.

resource_missing

The data item (charge, order, or refund) provided in the request does not exist.

Any

Transaction could not be processed due to incorrect or invalid data.

token_already_used

The source value is not a multi-pay token and was already used for a different payment.

Charge

Transaction could not be processed, please re-enter card details and retry.


Did this page help you?