Errors

Describing the general errors that may occur in the system.

General rest error model:

Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error due to a failure in the information provided (e.g., a required parameter was omitted, a charge was failed, etc.). Codes in the 5xx range indicate an error with Stripe's servers (this kind of error is rare).

Some 4xx errors could be handled programmatically (e.g., a card is declined). These errors include an error code that briefly explains the reported error.

Generally, users can interpret these error codes throughout the documents below:

👍

200 - OK

Everything worked as expected.

👍

201 - OK

Everything worked as expected.

❗️

401: Unauthorized

The request was unacceptable, often due to missing a required parameter.

❗️

403: Forbidden

When a user attempts to perform a task with the right privileges but not possible according to the consistency model of the application.

❗️

404 - Bad Request

When the input types or objects are not given properly.

❗️

500, 502, 503, 504 - Server Errors

Something went wrong on Stripe's end. (These are rare.)