NHN KCP(신모듈) 본인인증 연동하기
NHN KCP(신모듈) 본인인증 연동 방법을 안내합니다.
이 문서는 V1(구 아임포트) 연동 고객사 대상입니다. 신규 연동의 경우 V2 버전 사용을 권장합니다.
NHN KCP(신모듈) 본인인증 채널 설정하기
- 결제대행사 채널 설정하기 페이지의 내용을 참고하여 채널 설정을 진행합니다.
API 방식으로 본인인증하기
- 본인인증 관련 API페이지의 내용을 참고하여 연동을 진행합니다.
본인인증 요청 API
server-sideconst response = await fetch( `https://api.iamport.kr/certifications/otp/request`, { method: "POST", headers: { Authorization: `Bearer ${ACCESS_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ merchant_uid: "merchant_1234567890", name: "홍길동", phone: "01012345678", birth: "900101", gender_digit: "1", carrier: "SKT", is_mvno: false, verification_method: "SMS", ip: "127.0.0.1", bypass: { kcpV2: { media_type: "MC01", // PC web_siteid: "SITE_123456", cp_sms_msg: "인증번호는 [000000] 입니다.", cp_callback: "01012345678", }, }, }), }, ); const data = await response.json();
본인인증 요청하고자 하는 PG사의 채널키
pg 파라미터는 deprecated 되었기 때문에, 반드시 channelKey 파라미터에 본인인증을 요청하고자 하는 PG사 채널의 채널키를 입력해주세요.
본인인증 대상자 성명
본인인증 대상자 전화번호
본인인증 대상자 생년월일(YYMMDD)
주민등록번호 뒷부분 첫차리
외국인 고객은 다음 기준에 따라 입력해주세요:
- 남성: ~1999년생은 5, 2000년 이후 출생자는 7
- 여성: ~1999년생은 6, 2000년 이후 출생자는 8
통신사 코드
- SKT
- KT
- LGT
알뜰폰 사용 여부
알뜰폰 사용자의 경우, carrier 파라미터에 SKT, KT, LGT 중 하나를 지정 후 is_mvno 파라미터를 true로 지정합니다.
본인인증 방식
- SMS
- APP
미디어 타입
- PC : MC01
- MOBILE : MC02
고객사 주문번호
본인인증을 식별하기 위한 고객사의 주문 고유 번호로 매번 고유하게 채번되어야 합니다.
영어 대소문자와 숫자만 사용 가능하며 40자 이하로 입력해야 합니다.
KCP 사이트 식별코드
DI 생성 시 사용할 사이트 ID입니다. 미입력 시 KCP에서 발급한 사이트 ID로 설정됩니다.
CP 지정 SMS 메세지
인증번호 난수가 채워질 [000000] 부분만 제외 (6자리)하고 표시할 문자 발송 내용으로 요청 바랍니다. “[000000]” 문자열은 반드시 포함되어야 합니다.
ex) “cp_sms_msg” : “[TEST SHOP]이용자번호는[000000]입니다.”
CP 지정 callback 번호
인증번호 SMS의 발신자
본인인증 확인 API
sever-sideconst response = await fetch( `https://api.iamport.kr/certifications/otp/confirm/{imp_uid}`, { method: "POST", headers: { Authorization: `Bearer ${ACCESS_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ imp_uid: "imp_uid", otp: "123456", }), }, );
포트원 인증 고유번호
SMS로 전송된 인증번호
APP 방식 본인인증에서는 전달하지 않습니다.