Skip to main content

Error structure

All errors return JSON:
Validation errors include a field-level breakdown:

Common errors

401 Unauthenticated

Your API key is missing, malformed, or revoked. Check that you’re sending Authorization: Bearer chk_xxx.

400 Bad Request

An input value is structurally invalid. Check supported banks for valid bank codes.

404 Not Found

The transaction couldn’t be confirmed. This is a business-level result - the payment may be fake, the wrong reference was entered, or the bank hasn’t settled yet.

422 Validation Error

The request was well-formed but failed field-level validation. Check errors for details.

402 Payment Required

Your free quota is exhausted. Upgrade at check.et/dashboard/billing.

429 Rate Limited

Slow down requests. Retry after the Retry-After response header value (seconds).

500 Server Error

Unexpected error on our side. Retry with exponential back-off. If it persists, contact support on Telegram.

Retry strategy