Errors
Understanding API Responses: TipTop utilizes standard HTTP status codes to communicate the outcome of your API requests.
- Success (2xx codes): These codes indicate that your API call was processed successfully.
- Errors (4xx codes): These codes signify issues with your request itself. The response body will contain an error code, an error object, and additional details to help you pinpoint and address the problem. For instance, some 4xx errors (like a declined order) will include a specific error code with a brief explanation.
- Internal Server Errors (5xx codes): These codes indicate issues on TipTop's end. In such cases, please try your request again later. If the problem persists, contact TipTop support.
This approach ensures clear communication between your system and TipTop's API.
Field Names
Key | Type | Decription |
---|---|---|
status_code | string | HTTP status code. |
message | string | A helpful message in plain English about what went wrong. |
code | string | A concise error code for programmatic identification. |
type | string | A programmatic error identifier returned by the API. |
field | string | An incorrect or invalid value. |
Status Codes
Status Codes | Description |
---|---|
200 | Success |
400 | Bad request |
401 | Unauthorized |
402 | Request failed |
404 | Not found |
409 | Conflict |
500s | Internal Error |
Orders endpoint status codes
POST Capture Order
Status Codes | Error Message |
---|---|
403 | abc |
404 | abc |
409 | abc |
POST Void Order
Status Codes | Error Message |
---|---|
403 | abc |
404 | abc |
409 | abc |
POST Refund Order
Status Codes | Error Message |
---|---|
403 | abc |
404 | abc |
409 | abc |