에러 코드 v2
기본 응답코드
0000
정상
성공하였습니다.
모든 V2 API 정상 응답
ERROR
실패
처리 중 오류가 발생하였습니다.
알 수 없는 서버 오류 또는 미분류 예외
파트너 에러코드
PARTNER_001
실패
V2 버전의 파트너 하위 사업장 연동이 불가능한 파트너입니다.
apiKey가 V2 미지원 파트너로 식별된 경우
PARTNER_002
실패
apiKey 정보를 확인할 수 없습니다.
요청에 apiKey가 누락되었거나 형식이 잘못된 경우
PARTNER_003
실패
정상적인 파트너가 아닙니다.
apiKey로 파트너/매장/결제수단을 조회할 수 없는 경우
PARTNER_004
실패
찾을 수 없는 하위사업장 연동 정보입니다.
merchantId 또는 매핑 시퀀스로 매장 인증 정보를 찾지 못한 경우
PARTNER_005
실패
존재하지 않는 파트너입니다.
파트너 조회 실패
PARTNER_006
실패
적용중인 파트너 계약이 없습니다.
파트너 계약(서비스) 상태가 비활성인 경우
PARTNER_007
실패
제공되지 않는 서비스입니다.
파트너에게 해당 서비스(청구서 발송 발송 등) 권한이 없는 경우
파트너 맵핑 에러코드
PARTNER_MAPPING_001
실패
apiKey, memberId, merchantId는 필수 값입니다.
파트너 매핑 요청 시 필수 필드 누락
PARTNER_MAPPING_002
실패
잘못된 사업장등록번호 포맷입니다. 숫자 10자리를 입력하십시오.
사업자등록번호가 10자리 숫자가 아닌 경우
PARTNER_MAPPING_003
실패
파트너 하위사업장 심사 정보를 확인할 수 없습니다.
매장 심사(application) 정보 조회 실패
PARTNER_MAPPING_004
실패
삭제된 임시사업장을 연동할 수 없습니다.
삭제된 임시사업장으로 매핑 시도
PARTNER_MAPPING_005
실패
해당 파트너사에서 이미 맵핑된 임시사업장입니다.
동일 파트너에 중복 매핑 시도
PARTNER_MAPPING_006
실패
개시된 매장이 존재하지 않습니다.
매핑 대상 매장 중 개시 상태인 매장을 찾을 수 없음
PARTNER_MAPPING_007
실패
처리 불가능한 회원입니다.
회원 상태가 매핑/처리 불가 상태인 경우
값 검증 에러 코드
VALIDATION_001
실패
정상적이지 않은 데이터입니다. 연동규격서를 확인하시기 바랍니다.
요청값 검증 실패(필드 누락/형식 불일치)
VALIDATION_002
실패
정상적이지 않은 데이터입니다. 해싱값을 확인하시기 바랍니다.
hash 검증 실패
결제 에러 코드
PAYMENT_001
실패
결제를 처리 할 수 없습니다
VAN/현금영수증 발행 응답 누락·실패
PAYMENT_002
실패
결제 취소에 실패하였습니다.
결제/현금영수증 취소 시 정산·VAN·은행 응답 실패
PAYMENT_003
실패
100원 이상 청구할 수 있습니다.
청구 금액이 100원 미만
PAYMENT_004
실패
비정상적인 VAN 입니다.
결제수단(payType) 조회 실패 또는 사용 불가
PAYMENT_005
실패
개발 환경에서는 20000원 이상의 금액만 청구할 수 있습니다.
dev 환경에서 청구 금액이 20,000원 미만
청구서 에러 코드
BILL_001
실패
이미 사용된 billId 입니다.
동일 billId 로 청구서 재생성 시도
BILL_002
실패
기 취소된 청구서 입니다.
직접 취소 요청 시 취소 가능 상태 아님
BILL_003
실패
청구서를 찾을 수 없습니다.
billId/ledger/현금영수증 단건 조회 실패
BILL_004
실패
결제카드를 조회할 수 없습니다.
Keyin 카드 정보 복호화 실패
BILL_005
실패
요청한 txId로 청구서를 찾을 수 없습니다.
결과 콜백 또는 ledger 조회에서 txId 매칭 실패
BILL_006
실패
청구서 발송이 가능한 상태가 아닙니다.
재발송 시 청구서 상태가 발송 불가
BILL_007
실패
billId는 20자 이하여야 합니다.
요청 billId 길이 초과
BILL_008
실패
sendType은 필수값입니다. (TALK 또는 URL)
v2 청구서 생성시 타입 누락
BILL_009
실패
BILL_TALK 서비스를 사용할 수 없습니다.
파트너 계약시 TALK 타입 계약 되지 않음
BILL_010
실패
BILL_URL 서비스를 사용할 수 없습니다.
파트너 계약시 URL 타입 계약 되지 않음
포인트 에러 코드
POINT_001
실패
포인트가 부족합니다
청구서 발송 시 쌤포인트 잔액 부족
점검중 에러 코드
MAINTAINED_METHOD
실패
점검 중입니다.
야간작업, 장애 처리 등 점검 필요시
더 궁금한 내용이 있나요? 자주하는 질문
기술지원이 필요하신가요? 이메일 보내기