이름·생년월일·휴대전화 번호가 비었거나 형식이 틀림
400
입력 항목이 잘못됐습니다.(이름) — 괄호 안에 항목 이름(생년월일 8자리·휴대전화 번호)이 표시됩니다.
값을 고쳐 인증 요청을 다시 보냅니다. 인증이 발송되지 않아 과금되지 않습니다.
authProvider 가 허용값이 아니거나 지금 쓸 수 없는 인증방식
400
입력 항목이 잘못됐습니다.(인증방식)
간편인증 방식 표의 값(예: kakao)으로 보냅니다.
개인 공동인증서로 business_type=corporate 를 보냄
400
개인 공동인증서로는 법인(business_type=corporate) 조회를 할 수 없습니다. …
법인 공동인증서로 다시 요청합니다. 인증이 발송되지 않아 과금되지 않습니다.
법인 공동인증서로 business_type=personal 을 보냄
400
법인 공동인증서로는 개인(business_type=personal) 조회를 할 수 없습니다. …
법인 조회는 business_type=corporate 로, 개인 조회는 개인 인증서나 간편인증으로 보냅니다. 과금되지 않습니다.
개인만 조회할 수 있는 상품에 법인 공동인증서를 씀
400
법인 공동인증서로는 조회할 수 없는 상품입니다. 개인 인증서나 간편인증으로 조회해 주세요.
개인 공동인증서나 간편인증으로 다시 요청합니다. 과금되지 않습니다.
business_no 가 없거나 10자리가 아님
400
입력 항목이 잘못됐습니다.(사업자등록번호 10자리)
사업자등록번호 10자리를 숫자로 보냅니다.
bind_id 없이 agreed 를 빠뜨림
400
입력 항목이 잘못됐습니다.(agreed)
agreed=true 를 함께 보냅니다.
bind_id 유효기간이 지났거나 폐기됨
410
사업자 인증 유효기간이 지났습니다. 다시 인증해 주세요.
bind_id 를 빼고 agreed=true 로 다시 접수합니다.
없는 bind_id
404
사업자 인증 정보를 찾을 수 없습니다.
bind_id 를 빼고 agreed=true 로 다시 접수합니다.
bind_id 의 사업자등록번호와 business_no 가 다름
400
입력한 사업자등록번호가 인증된 번호와 다릅니다.
bind_id 를 만든 사업자등록번호로 보내거나, bind_id 없이 agreed=true 로 접수합니다.
같은 상품의 앞선 요청을 처리하는 중
429
앞선 요청을 처리하고 있습니다. 잠시 후 다시 시도해 주세요.
인증 요청을 다시 보내지 말고 잠시 뒤 받은 transactionId 로 결과를 조회합니다.
보유 포인트가 이번 호출 단가보다 적음
200
data 대신 result.error 에 사용 가능한 포인트이 부족합니다.
충전한 뒤 다시 호출합니다. 결과조회는 같은 transactionId 를 그대로 씁니다.
결과를 청구하는 순간 포인트가 부족함
402
결제 금액보다 보유 포인트이 부족합니다.
충전한 뒤 같은 transactionId 로 다시 조회합니다. 결과는 24시간 보관됩니다.
결과조회에 transactionId 가 없음
400
입력 항목이 잘못됐습니다.(transactionId)
인증 요청 응답의 transactionId 를 보냅니다.
없는 transactionId 또는 다른 상품의 결과조회 경로
404
요청을 찾을 수 없습니다.
인증 요청한 상품의 /rest/get_business_sales 로 조회합니다.
사용자가 승인을 거부함
200
없음 — status=AUTH_REJECTED, errorCode=AUTH_REJECTED
다시 시도할지 사용자에게 묻고 인증 요청부터 다시 합니다(인증 요청 단가가 다시 발생).
5분 안에 승인하지 않음
200
없음 — status=AUTH_EXPIRED, errorCode=AUTH_EXPIRED
인증 요청부터 다시 합니다. 결과 단가는 발생하지 않습니다.
조회하지 못함(대상이 아니거나 일시적으로 처리하지 못함)
200
없음 — status=FAILED, errorCode=COLLECT_FAILED. 원인이 분명하면 data.message 에 조치 문구가 옵니다(예: 기관 서비스 점검·중지, 사업자 세적정보를 확인하지 못함, 휴업·폐업 사업자, 로그인한 계정과 사업자 구분이 다름).
결과 단가는 발생하지 않습니다. data.message 가 있으면 그 안내대로 고칩니다. 입력값과 대표자 본인 여부를 확인한 뒤 잠시 후 인증 요청부터 다시 합니다.
기관이 서비스 점검(중지) 중이라 결과를 만들지 못함
200
없음 — status=FAILED, errorCode=SERVICE_MAINTENANCE, maintenance=true. data.message 에 점검 안내가 옵니다.
요청 오류가 아닙니다. 입력값을 고칠 필요가 없고 결과 단가도 발생하지 않습니다. 점검 시간이 끝난 뒤 인증 요청부터 다시 합니다.
결과 재조회 기간(24시간)이 지남
200
없음 — errorCode=RESULT_EXPIRED
받은 결과는 바로 저장해 두세요. 다시 받으려면 인증 요청부터 합니다.