Skip to main content

​
Kashimi’s API Error Handling

Kashimi’s API uses standard HTTP response codes to indicate the success or failure of API requests. 2xx Range (Success) Codes in this range indicate a successful API request. The requested operation was completed as expected. 4xx Range (Client Errors) Codes in this range indicate an error related to the client’s request. These errors may occur due to missing required parameters, payment failures, or other client-specific issues. 5xx Range (Server Errors) Codes in this range indicate an issue with Kashimi’s servers. When you encounter a code in this range, it means the problem is on our side, not the client’s request. Understanding these response codes will help you handle different scenarios appropriately and ensure smooth integration with Kashimi’s API.

​
HTTP Status Code Summary

Status Code
Title
Description
400Bad RequestThe request is malformed or missing the required fields.
400Bad RequestOne or more fields in the request failed validation.
401UnauthorizedInvalid credentials.
403ForbiddenYour credentials do not have permission to perform this action.
404Not FoundThe requested resource does not exist.
409ConflictPayment with this end-to-end ID already exists.
422Unprocessable EntityPayment object is invalid for the selected provider.
429Too Many RequestsToo many requests have been sent in a short period of time.
500Internal Server ErrorAn unexpected error occurred.
503Service UnavailableThe service is temporarily unavailable, usually due to maintenance or overload.

​
Error Fields

Field
Type
Required
Description
titlestring✅Short label describing the error
httpStatusCodeinteger✅HTTP status code (e.g., 400 = Bad Request)
messagestring✅Human-readable explanation of the error
{
  "title": "Forbidden",
  "statusCode": 400,
  "errorCode": "GENERAL_INPUT_VALIDATION_FAILED"
}