Skip to main content
The Kotani Pay API uses standard HTTP status codes. 2xx means success, 4xx means the request was rejected, 5xx means something failed on the server.

Response Envelope

All responses — success and error — follow a consistent envelope. Success:
Error:
The error_code field mirrors the HTTP status code. For validation failures, data.errors contains the individual field messages:

Status Codes


Rate Limit Errors

When rate limited, the data field includes how long to wait:

Customer Suspension

If a customer_key belongs to a suspended customer, the request returns 403: