본문으로 건너뛰기

에러 코드

API 요청 시 발생할 수 있는 에러 코드 목록입니다. 에러 응답의 code 필드를 기반으로 에러 유형을 구분하고 적절히 처리하시기 바랍니다.

에러 응답 형식​

{
  "success": false,
  "code": "INVALID_SIGNATURE",
  "message": "Invalid signature"
}

인증 에러 — 401 Unauthorized​

코드설명해결 방법
INVALID_CLIENT_KEY유효하지 않은 Client KeyClient Key가 올바른지 확인합니다.
INVALID_SIGNATURE서명 검증 실패인증 문서를 참고하여 서명 생성 로직을 확인합니다.
EXPIRED_TIMESTAMP타임스탬프 만료 (±5분 초과)서버 시간이 NTP와 동기화되어 있는지 확인합니다.
EXPIRED_API_KEY만료된 API Key대시보드에서 새 API Key를 발급받습니다.
REVOKED_API_KEY폐기된 API Key대시보드에서 새 API Key를 발급받습니다.

요청 에러 — 400 Bad Request​

코드설명
INVALID_PARAMETER요청 파라미터의 형식 또는 값이 올바르지 않습니다.
MISSING_PARAMETER필수 파라미터가 누락되었습니다.
INVALID_AMOUNT유효하지 않은 금액입니다.
AMOUNT_TOO_SMALL최소 금액 미만입니다.
AMOUNT_TOO_LARGE최대 금액을 초과하였습니다.

리소스 에러 — 404 Not Found​

코드설명
INVOICE_NOT_FOUND인보이스를 찾을 수 없습니다.
PROJECT_NOT_FOUND프로젝트를 찾을 수 없습니다.

상태 에러 — 409 Conflict​

코드설명
INVOICE_ALREADY_PAID이미 결제가 완료된 인보이스입니다.
INVOICE_EXPIRED만료된 인보이스입니다.

서버 에러 — 500 Internal Server Error​

코드설명
INTERNAL_SERVER_ERROR서버 내부 오류가 발생하였습니다.
정보

서버 에러가 지속적으로 발생하는 경우 support@oozoo.com으로 문의하시기 바랍니다.