<- Object

Object

ErrorCategory

Indicates which high-level category of error has occurred during a request to the Connect API.

Link to section

Values

Link to section

API_ERROR

An error occurred with the Connect API itself.

Link to section

AUTHENTICATION_ERROR

An authentication error occurred. Most commonly, the request had a missing, malformed, or otherwise invalid Authorization header.

Link to section

INVALID_REQUEST_ERROR

The request was invalid. Most commonly, a required parameter was missing, or a provided parameter had an invalid value.

Link to section

RATE_LIMIT_ERROR

Your application reached the Square API rate limit. You might receive this error if your application sends a high number of requests to Square APIs in a short period of time.

Your application should monitor responses for 429 RATE_LIMITED errors and use a retry mechanism with an exponential backoff schedule to resend the requests at an increasingly slower rate. It is also a good practice to use a randomized delay (jitter) in your retry schedule.

Link to section

PAYMENT_METHOD_ERROR

An error occurred while processing a payment method. Most commonly, the details of the payment method were invalid (such as a card's CVV or expiration date).

Link to section

REFUND_ERROR

An error occurred while attempting to process a refund.

Link to section

MERCHANT_SUBSCRIPTION_ERROR

Beta

An error occurred when checking a merchant subscription status

Link to section

EXTERNAL_VENDOR_ERROR

An error that is returned from an external vendor's API