오류 코드

HTTP 상태, error.code, error.action을 함께 사용합니다. 다음은 대표 그룹이며 엔드포인트별 오류는 API Reference가 기준입니다.

HTTP	대표 코드	일반적인 처리
400	MISSING_REQUIRED_FIELD, INVALID_FIELD_VALUE	요청 수정
401	INVALID_API_KEY, INVALID_TIMESTAMP, NONCE_REPLAYED, INVALID_SIGNATURE	인증 수정
403	FORBIDDEN, ACCOUNT_NOT_ACTIVE	권한·상태 확인
404	ACCOUNT_NOT_FOUND, DEPOSIT_NOT_FOUND, WITHDRAWAL_NOT_FOUND, LEDGER_NOT_FOUND	환경과 ID 확인
409	CONFLICT, WITHDRAWAL_NOT_CANCELLABLE	기존 상태 복구·해결
422	INVALID_AMOUNT, INSUFFICIENT_BALANCE, 금액 한도 오류	금액·잔액 수정
429	RATE_LIMITED	제한된 지연 재시도
503	SERVICE_MAINTENANCE, NETWORK_UNAVAILABLE, ASSET_UNAVAILABLE	제한된 지연 재시도
500	INTERNAL_ERROR	생성 결과 복구 후 지원 문의

알 수 없는 코드는 안전하게 실패 처리하고 기록합니다. message는 사람이 읽는 지역화 문자열입니다. 지원 문의에는 request_id를 포함하고 자격 증명은 제외합니다.

Action 처리

RETRY_LATER가 모든 요청을 그대로 반복할 수 있다는 뜻은 아닙니다. 허용된 읽기 요청은 backoff로 재시도하고 금융 생성 요청은 먼저 client_request_id로 복구합니다. ADJUST_AMOUNT, INCREASE_BALANCE, REQUEST_ACCESS 등은 새로운 고객 또는 운영 판단이 필요합니다.

알 수 없는 code나 action은 검토 전까지 재시도 불가로 처리합니다. 새 서버 코드가 retry storm을 만들지 않도록 HTTP 상태, 안전한 응답 metadata, request correlation을 보존합니다.