Errors

The Yoco Checkout API uses standard HTTP response codes.

Codes in the 2xx range indicate success.

Codes in the 4xx range indicate client errors (e.g., missing parameters).

Codes in the 5xx range indicate server errors.

Common Errors

DescriptionReasonSolution
CORSThe request is not sent over HTTPS from your server.Make all API calls from your server using HTTPS.

HTTP Response Errors

Status codeDescriptionReasonSolution
403A key is required, but has not been specified.Secret API key is missing or incorrect.Ensure the Authorization header is present and correct. See Authentication.
409ConflictA request with the same idempotency key is already being processed.Try again later or use a different idempotency key. See Idempotency.
422The request payload does not match the original request.Duplicate idempotency key with different payload.Use a unique idempotency key for each request. See Idempotency.