에러 코드 레퍼런스
FakeToss 서버와 SDK에서 자주 보게 되는 에러 코드를 정리했습니다. 서버 정의에 있는 코드와 문서 요구 코드를 함께 포함합니다.
| HTTP | code | 기본 메시지 | 발생 시점 |
|---|---|---|---|
| 400 | INVALID_REQUEST | 잘못된 요청입니다. | 잘못된 body, 필수값 누락 |
| 401 | UNAUTHORIZED_KEY | 인증 정보가 올바르지 않습니다. | Basic Auth Secret Key 오류 |
| 404 | NOT_FOUND_PAYMENT | 결제 정보를 찾을 수 없습니다. | paymentKey 또는 orderId 조회 실패 |
| 400 | ALREADY_PROCESSED_PAYMENT | 이미 처리된 결제입니다. | 중복 승인 요청 |
| 403 | NOT_CANCELABLE_PAYMENT | 취소할 수 없는 결제입니다. | 취소 불가 상태 결제 취소 시도 |
| 403 | NOT_ALLOWED_PARTIAL_REFUND | 부분 취소가 허용되지 않습니다. | 부분 취소 미지원 결제에 부분 환불 시도 |
| 400 | INVALID_CARD_NUMBER | 카드번호를 확인해주세요. | 카드 입력 검증 실패 또는 시나리오 강제 |
| 400 | INVALID_CARD_EXPIRATION | 카드 유효기간을 확인해주세요. | 유효기간 검증 실패 |
| 400 | INVALID_STOPPED_CARD | 사용이 정지된 카드입니다. | 정지 카드 사용 |
| 400 | NOT_SUPPORTED_CARD_TYPE | 지원하지 않는 카드입니다. | 미지원 BIN 또는 카드 타입 |
| 403 | REJECT_CARD_PAYMENT | 한도초과된 카드입니다. | 카드사/발급사 승인 거절 |
| 400 | EXCEED_MAX_AMOUNT | 허용 금액을 초과했습니다. | 최대 결제 금액 초과 |
| 400 | USER_CANCELED | 사용자가 결제를 취소했습니다. | 프론트 SDK 취소 이벤트 표기용 |
| 400 | PAY_PROCESS_CANCELED | 사용자가 결제를 취소했습니다. | 결제창에서 사용자 취소 |
| 500 | FAILED_PAYMENT_INTERNAL_SYSTEM_PROCESSING | 결제 승인에 실패했습니다. | 내부 처리 실패 또는 실패 시나리오 |
| 400 | INVALID_ORDER_ID | 유효하지 않은 주문번호입니다. | SDK/서버에서 orderId 형식 검증 실패 |
| 403 | FORBIDDEN_INTERNAL | 내부 API 토큰이 올바르지 않습니다. | 관리자 내부 API 호출 실패 |
| 404 | NOT_FOUND_MERCHANT | 가맹점을 찾을 수 없습니다. | merchantId 또는 가맹점 설정 조회 실패 |