Error codes

KODIPAY API errors follow a consistent JSON shape:

• message
• code
• optional details

Examples of important v1 cases:

• reference_already_used with a 409 Conflict when a reference already exists for the same merchant
• validation_error when the payload is invalid
• unauthenticated when the Bearer token is missing or invalid
• forbidden when the token cannot access the requested resource

See the generated examples in API Reference.