Clover Status Codes and Error Reference
The API returns messages in one of two categories—Successful (2xx) or Unsuccessful (4xx and 5xx). The following table describes the status codes that may be returned in response to a request.
200 Requested action successfully processed by the device.
209 Operation canceled by user request.
400 Request is invalid, and subsequent calls will continue to fail. Do not repeat the call.
401 Invalid bearer token provided. You can repeat the call if the provided bearer token is updated.
415 Request is invalid and contains request data in an unsupported format. You can repeat the call if the content is changed to a supported format.
500 Request processing failed with an unknown error, and the processing state of the operation is indeterminate. Do not repeat the call without additional analysis.
501 Device is not available for this call and cannot respond. Do not repeat the call.
503 Device is not available because it is handling another request. You can repeat the current request later.504Device did not respond in a timely manner. You can repeat the current request later.
Error codes from Clover Payment APIs
Code
amount_too_large
card_declined
card_on_file_missing
charge_already_captured
charge_already_refunded
email_invalid
expired_card
incorrect_cvc
incorrect_number
invalid_card_type
invalid_charge_amount
invalid_request
invalid_tip_amount
invalid_tax_amount
Missing
order_already_paid
processing_error
rate_limit
resource_missing
token_already_used
Description
The amount provided exceeds the amount allowed by Clover ($999, 999.99).
The source provided was declined by the payment gateway.
The customer attempting to pay does not have a source on file to complete the payment.
The charge provided has already been captured.
The charge provided has already been refunded.
The email provided is not valid.
The expiration date (the combination of card.exp_month and card.exp_year) provided is in the past.
The card.cvv provided is not a three- or four-digit value.
The value provided in card number is not valid.
The card.brand provided is not a recognized value.
The amount provided exceeds the amount allowed by Clover.
The value provided in card.number is not a valid raw or encrypted PAN.
The tip_amount provided is not a valid amount.
The tax_amount provided is not a valid amount.
The token request failed upstream, and the upstream message could not be processed.
The order identified by the ID in the request URL has already been paid.
A generic error indicating that the request could not be processed as submitted.
Your application made too many requests and additional requests will not be processed until the rate limit expires.
The data item (charge, order, or refund) provided in the request does not exist.
The source value is not a multi-pay token and was already used for a different payment.
Message to buyer
Transaction cannot be processed, please contact the merchant.
Transaction declined, please use a different card.
Transaction failed, incorrect card data.
Transaction has already been captured.
Transaction has already been refunded.
Email ID is invalid, enter valid email ID and retry.
Card expired, enter valid card number and retry.
CVV value is incorrect, enter correct CVV value and retry.
Card number is invalid, enter valid card number and retry.
Card brand is invalid or not supported, please use valid card and retry.
Invalid transaction amount, please contact merchant.
Card is invalid, please retry with a new card.
Invalid tip amount, please correct and retry.
Incorrect tax amount, please correct and retry.
Unable to process transaction.
Order already paid.
Transaction could not be processed.
Transaction could not be processed, please contact the merchant.
Transaction could not be processed due to incorrect or invalid data.
Transaction could not be processed, please re-enter card details and retry.
