휴대폰 본인인증 화면
이해하기
shop by pro 에서는 회원 본인인증 방법으로 이메일 인증/ SMS 인증 / 휴대폰 인증 총 3가지 인증 방법을 제공하고 있습니다.
어드민 [설정> 기본정책 >쇼핑몰관리> 회원 인증 설정]에서 설정할 수 있으며
본 문서는 이 중 '휴대폰 인증'으로 설정한 경우 노출되는 NHN KCP 휴대폰 인증 모듈에 대해 소개합니다.
참고로 회원 본인 인증의 경우, 아래와 같은 화면에서 활용됩니다.
- 1. 아이디 및 비밀번호 찾기 시
- 2. 성인 인증 필요 시(성인인증 사용 상품 구매 및 성인인증 인트로페이지)
- 3. 회원 휴면 해제 시
- 4. 마이페이지 회원정보 수정 시
- 5. 쇼핑몰 회원가입 시
ⓐ 휴대폰 본인인증 버튼
어드민 [설정> 기본정책 >쇼핑몰관리> 회원 인증 설정]에서 회원 인증 설정을 '휴대폰 인증'으로 설정한 경우
화면 내 '휴대폰 인증 버튼'이 노출 됩니다.
- get쇼핑몰 기본 정보 조회
- /malls
쇼핑몰 전반에 대한 기본 정보와 설정 데이터를 조회할 수 있습니다.
샵바이 API 호출가이드 문서에서 소개한 GET /malls 내 mallJoinConfig 값을 통해
어드민의 휴대폰 인증 사용함 여부를 확인합니다.
아래 코드를 만족했을 때 휴대폰 본인 인증이 가능하며, 휴대폰 인증 버튼이 노출됩니다.
1
2 const {(authenticationTimeType, authenticationType)} = shopby.cache.getMall().mallJoinConfig;
3 this.isAuthPhoneConfig = authenticationTimeType === 'JOIN_TIME' && authenticationType === 'AUTHENTICATION_BY_PHONE';
4 ⓑ NHN KCP 인증모듈 로직
휴대폰 본인인증 버튼이 노출된 쇼핑몰 화면에서 버튼 클릭 시,
/callback/kcp-auth-callback.html 을 통해 URI key 값 여부를 확인합니다
KCP 인증 모듈 팝업을 출력하기 위해서 GET /kcp/id-verification을 호출하여 KCP로 제출할 HTML form을 전송받아야 합니다.
해당 API를 통해 HTML form 생성 시, 화면 내 'NHN KCP 인증 팝업 (외부모듈)'이 노출됩니다.
※ 위 API가 아닌 임의로 form을 작성할 경우, NHN커머스 샵바이측으로 callback을 받을 수 없습니다. 반드시 위 API 응답값으로 받은 폼을 사용하시길 바랍니다.
- getKCP 본인인증 요청
- /kcp/id-verification/form
본인 인증을 위한 form을 생성합니다
'NHN KCP 인증팝업(외부 모듈)'을 통해 사용자가 인증에 성공하면, callback 주소로 본인인증 키 key 가 전달됩니다.
이 때, 본인인증된 CI값을 NHN커머스 샵바이 서버에서 저장합니다.
해당 key 를 파라미터 값으로 본인인증 인증 성공 및 실패 여부를 판단한 뒤, 화면에 성공 및 실패 결과를 전달합니다.
성공 시 다음 화면으로 리다이렉트 되며 팝업이 종료됩니다.
- get본인인증 결과 조회
- /kcp/id-verification/response
NHN KCP 본인인증 결과를 확인합니다
위 API를 호출하여 CI값을 취득할 수 있습니다.
성공 시 다음 화면으로 리다이렉트 되며 팝업이 종료됩니다.
만약 '회원가입 화면'에서 휴대폰 본인인증을 진행하고 있었다면,
본인인증 성공 시 해당 API 응답 값 중 ci 값을 회원가입 화면 으로 전달하여 CI 중복 확인을 추가적으로 진행해야 합니다.(동일한 회원인증 정보로 중복 회원가입 방지 목적) 해당 회원가입 화면 가이드를 이어서 확인하시길 바랍니다.
NHN KCP 본인인증 성공 시 만약 해당 회원이 로그인 상태였다면(accessToken을 가지고 있었을 경우), 성인인증 여부를 갱신해야 합니다.
- post성인 인증
- /kcp/age-verification
회원 성인인증 여부를 갱신합니다
POST /kcp/age-verification에서 이전 단계에서 획득한 key 파라미터로 사용합니다.
한 번 성인인증을 완료한 회원은 인증을 완료한 시점부터 1년간 인증 기록이 유지됩니다.
기간 내 다시 본인인증에 성공할 경우 성인인증 일시가 갱신됩니다.