Errors | Yoco Developer Hub

The Yoco Checkout API uses standard HTTP response codes.

Codes in the 2xx range indicate success.

Codes in the 4xx range indicate client errors (for example, missing parameters).

Codes in the 5xx range indicate server errors.

Description	Reason	Solution
CORS	The request is not sent over HTTPS from your server.	Make all API calls from your server using HTTPS.

Status code	Description	Reason	Solution
403	A 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.
409	Conflict	A request with the same idempotency key is already being processed.	Try again later or use a different idempotency key. See Idempotency.
422	The request payload does not match the original request.	Duplicate idempotency key with different payload.	Use a unique idempotency key for each request. See Idempotency.