requestIdentityVerification 요청 형식
requestIdentityVerification 호출 시 사용되는 파라미터의 형식을 확인할 수 있습니다.
requestIdentityVerification
요청 데이터 정의
스토어 아이디
- 포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다.
본인인증건 고유 번호
- 고객사가 채번하는 본인인증 건에 대한 고유 번호입니다.
- 이미 본인인증이 완료된
identityVerificationId
로 다시 본인인증을 시도하는 경우 에러가 발생합니다.
채널 키
콘솔에서 채널 연동 시 생성된 채널 키입니다.
구매자 고유 ID
구매자 전체 이름
fullName
과 firstName
/ lastName
이 모두 입력된 경우 fullName
으로 기록됩니다.
구매자 이름
firstName
을 입력하는 경우 lastName
도 필수로 입력해야 합니다. fullName
이 없고,
firstName
과 lastName
이 존재하는 경우 {firstName} {lastName}
으로 저장됩니다.
구매자 성
lastName
을 입력하는 경우 firstName
도 필수로 입력해야 합니다.
구매자 연락처
구매자 이메일 주소
유효한 이메일 주소를 입력해주세요.
주소 정보
국가
일반주소
상세주소
도시
주, 도, 시
구매자 우편번호
구매자 성별
구매자 출생년도
ex. "1990"
같은 형식으로 입력해주세요.
구매자 출생월
ex. "12"
, "07"
같은 형식으로 입력해주세요.
구매자 출생일
ex. "25"
, "08"
같은 형식으로 입력해주세요.
구매자 이름 후리가나
일본어 읽는 법 표기
구매자 성 후리가나
일본어 읽는 법 표기
환경 별 제공되는 결제/본인인증 창 유형
- PG사에 따라 가능한 창 유형이 다릅니다.
- 전달되지 않았을 때 결정되는 기본 창이 다릅니다.
- 미입력 시, 해당 PG사의 기본 창 방식을 따릅니다.
리디렉션 방식에서 프로세스 완료 후 이동될 고객사 URL
- 결제/본인인증 창이 새로운 창으로 리다이렉트 되어 프로세스가 진행되는 방식인 경우 필수 설정 항목 입니다.
- 대부분의 모바일 환경에서 창 호출시 필수 항목입니다.
- 리다이렉트 환경에서 해당 필드 누락시 에러가 발생합니다.
본인인증 정보와 함께 관리하고 싶은 고객사 커스텀 JSON 데이터
PG사 본인인증 창 호출 시 PG사로 그대로 bypass할 값들의 모음
다날 bypass 파라미터
고객사 서비스 URL 혹은 본인확인 기능 사용 경로
- 본인확인 기능을 앱에서만 사용하는 경우 서비스 홈 URL 입력. Ex)
m.login.MarketC.co.kr
- 본인확인 기능을 사용하는 웹 페이지가 존재할 경우 해당 URL 입력. Ex)
www.MarketA.co.kr
- 웹 서비스 URL 자체가 존재하지 않는 경우 서비스 이름 (app 이름) 입력. Ex)
마켓A
- 해당 값을 넘기지 않을 경우
포트원
으로 default 값을 채웁니다.
본인인증을 진행할 수 있는 최소 만 나이
해당 값을 채워서 요청할 경우 본인인증을 진행할 수 있는 최소 만 나이를 설정할 수 있습니다.
통신사 정보
인증 화면에서 해당 통신사만 활성화시킬 수 있습니다.
가능한 값: SKT
, KTF
, LGT
, MVNO
여러 개의 통신사를 활성화시키려면 위 값들을 semicolon(;
) 으로 이어야 합니다. ex) SKT;KTF
KG이니시스 bypass 파라미터
단독 노출할 인증 업체 코드
인증 업체 선택 화면 없이 설정한 인증 업체를 통해 인증하도록 합니다.
인증 창에서 고객 정보를 미리 채울지 여부
Y
, N
중 하나를 입력해주세요.
Y
인 경우 이름, 연락처, 출생년도, 출생월, 출생일을 필수로 입력해야 합니다.
인증 창에 표시할 로고 URL
인증 창 좌측 상단 KG이니시스 로고 대신 들어갈 로고의 URL입니다. 최적 크기는 가로 164px, 세로 28px입니다.
HTTP URL인 경우 로고가 표시되지 않을 수 있습니다.
DI를 생성할 때 사용할 salt
결제창이 팝업 방식일 경우 결제창에 적용할 속성
true
로 설정하면 결제창이 브라우저 화면의 정중앙에 표시됩니다.