IAiamport
certifications

본인인증 요청 API

사용자 개인정보를 API로 전달하여, 통신사로부터 확인되는 경우 OTP(6자리 인증번호)를 사용자에게 SMS로 전달합니다. <br><br>통신사 승인을 받은 일부 고객사에 한해 사용하실 수 있으며, 현재 <b>다날</b>, <b>kcp(신모듈)</b>을 통해서만 서비스되고 있습니다. <br><br>본인인증 대상자의 성명, 생년월일 + 주민등록 뒷부분 첫 자리, 휴대폰번호, 통신사 정보를 고객사에서 직접 입력받아 API요청하면 됩니다. 전달된 개인정보가 올바를 경우 해당 휴대폰으로 인증번호 SMS가 전송됩니다. <br><br>200응답 시 imp_uid 가 응답데이터로 전달되며, SMS전송된 인증번호를 본인인증 완료 API 로 요청주시면 최종 본인인증 프로세스가 완료됩니다.

post/certifications/otp/request

Request

Request body application/x-www-form-urlencoded

namestring required

본인인증 대상자 성명

phonestring required

본인인증 대상자 전화번호<br>(- 또는 . 과 같은 기호가 포함되어도 무방 - 포트원 내에서 숫자 외에는 정규식으로 모두 제거처리)

birthstring required

본인인증 대상자 생년월일<br> YYMMDD 6자리(연/월/일 사이에 - 또는 . 과 같은 기호가 포함되어도 무방 - 포트원 내에서 숫자 외에는 정규식으로 모두 제거처리함)

gender_digitstring required

본인인증 대상자 주민등록번호 뒷부분 첫자리(주민등록번호 13자리 중 7번째 자리<br>2000년 이전 출생자는 1 또는 2, 2000년 이후 출생자는 3 또는 4) <br><br> 외국인 고객은 다음 기준에 따라 입력해주세요:

  • 남성: ~1999년생은 5, 2000년 이후 출생자는 7
  • 여성: ~1999년생은 6, 2000년 이후 출생자는 8
carrier'SKT' | 'KT' | 'LGT' required

본인인증 대상자 통신사 코드 (알뜰폰 사용자의 경우, carrier파라메터 SKT, KT, LGT 중 하나를 지정한 후 <b>is_mvno : true</b> 로 설정) <ul><li>SKT</li> <li>KT</li> <li>LGT</li></ul>

is_mvnoboolean

본인인증 대상자 알뜰폰 사용 여부

companystring

고객사 서비스명칭 또는 domain URL. <br> KISA에서 대상자에게 발송하는 SMS에 안내될 서비스 명칭

merchant_uidstring

본인인증 요청건을 식별하기 위한 고객사 주문번호

pgstring

PG사 구분자<br>다날 상점아이디를 2개 이상 동시에 사용하시려는 경우 설정하시면 됩니다. <b>danal.{상점아이디}</b> 형태로 지정. Deprecated 되었으므로 channel_key 파라미터를 사용해주세요.

channel_keystring required

본인인증을 요청하고자 하는 PG사의 채널키로 kcp(신모듈) 본인인증을 사용하시려는 경우 반드시 channel_key를 입력해야합니다.

verification_method'SMS' | 'APP'

본인인증을 진행하고자 하는 방식.

  • SMS
  • APP

지원하는 pg사

  • kcp(신모듈)
bypassstring

JSON string 형식의 PG사별로 특화된 파라미터. <br>전달 한 값은 가공 없이 그대로 PG사로 전달 됩니다. <br>각 PG사별 스펙은 PG사별 연동 문서 참고해주세요

Response

본인인증을 위한 대상자 정보 검증 완료(인증번호 SMS전송요청 중)

codeinteger

0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다

messagestring

code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다

Changes

No recorded changes to this operation across all 1 revision of this API.