Web manual

카드본인확인서비스

본인 명의의 신용/체크카드를 활용하여 본인임을 확인하는 서비스

개발 언어에 맞는 샘플을
다운로드 받아 주세요.

요청페이지 도메인과 일치하도록 Okurl, Closeurl 값을
수정해 주세요.

인증 진행과정과
응답결과를 확인해 주세요.

가맹점 실서버 환경에 맞게
연동을 진행해주세요.

카드본인확인서비스 연동 전, 체크해야할 사항을 안내드립니다.

계약 완료 여부, 사용 가능 인증서 등은 계약담당자 문의

카드본인확인 계약 시 안내받은 SEED암호화 key, iv 사용

카드본인확인서비스 연동 시 유의할 사항에 대하여 안내드립니다.

유의사항을 준수하지 않음으로 인해 발생되는 문제에 대하여는 당사에서 책임지지 않습니다.

모바일 연동 시 유의사항
- 일반적인 모바일웹 환경은 연동규격이 동일합니다.
- 가맹점 앱 내 웹뷰(WebView) 연동 시, 팝업창 호출에 제한이 있으므로 페이지 전환방식으로 연동바랍니다.
- 웹뷰(WebView) 연동 시 스크립트가 작동하지 않으므로, Closeurl 을 설정하여 해당페이지로 이동할 수 있도록 작업해주시기 바랍니다.
(취소버튼 or 닫기버튼 클릭 시 사용)

mid*	상점아이디	10 byte
Siteurl*	가맹점도메인 (UTF-8 URLEncoding) 예:www.inicis.com	100 byte
Tradeid*	가맹점 거래번호 (요청시마다 유일값)	20 byte
DI_CODE	웹사이트 코드 (DI 생성시 활용) DI 사용시 필수	12 byte
MSTR	가맹점 콜백변수 (UTF-8 URLEncoding) 가맹점에서 추가적으로 파라미터가 필요한 경우 사용. 특수문자 "&", "%" 사용불가 (예: MSTR="a=1\|b=2")	1000 byte
Closeurl*	취소, 닫기버튼 클릭 시 호출되는 가맹점페이지 URL (UTF-8 urlEncoding)	128 byte
Okurl*	인증응답 결과 전달용 가맹점 완료페이지 URL (UTF-8 urlEncoding)	128 byte
encryptYN	인증응답 결과 중 Ci & Di 를 SEED 암호화로 받을지 여부 ["Y" 결과 암호화 고정]	1 byte

Resultcd	결과코드 "0000":성공, 이외 실패	에러코드 4 byte
Resultmsg	결과메시지 (UTF-8 urlEncoding) ex) "성공" 문자열 응답 시 : %EC%84%B1%EA%B3%B5	100 byte
Transid	트랜잭션 ID, 이니시스에서 생성	20 byte
Tradeid	가맹점 거래번호 카드 본인인증 요청 결과의 Tradeid 와 일치여부 확인 필수	20 byte
MSTR	가맹점 콜백변수 (UTF-8 urlEncoding)	1000 byte
Signdate	인증일자 (YYYYMMDDHH24MISS)	14 byte
Name	이름(사용자명) SEED암호화 (Decoding 필요시 EUC-KR로 진행 필수)	SEED 25 byte
Socialno	생년월일 (YYYYMMDD) SEED암호화	SEED 8 byte
Sex	성별 [F : 여성, M : 남성] SEED암호화	SEED 1 byte
Foreigner	외국인 여부 [L : 내국인, F : 외국인] SEED암호화	SEED 1 byte
Ci	Ci (기 암호화) SEED암호화	SEED 150 byte
Di	Di (기 암호화) SEED암호화	SEED 150 byte
Ci2	Ci2 SEED암호화	SEED 150 byte
CiUpdate	Ci 업데이트 횟수	1 byte
DI_CODE	웹사이트 코드 (Di 생성시 활용)	12 byte
Mac	SHA256 Hash value 대상 : mid, Signdate, Ci, Tradeid, Transid	HASH 100 byte

카드본인확인서비스를 가맹점앱 내 웹뷰로 연동할 경우 참고할 수 있는 카드사별 앱스킴URL 을 안내합니다.

카드사	URL
KB국민카드	Kb-auth://pay?srCode=[[QRCODE]]
롯데카드	lotteappcard://data?apptid=kcb&acctid=card&act=auth&de_seq=[[QRCODE]]
비씨카드	ispmobile://?cardauth=[[QRCODE]]
삼성카드	mpocket.online.ansimclick://?xid=[[QRCODE]]
신한카드	shinhan-sr-ansimclick://pay?srCode=[[QRCODE]]
하나카드	cloudpay://cpy?tid=[[QRCODE]]
현대카드	hyundaicardappcardid://identification?qr=[[QRCODE]]
NH농협카드	nhallonepayansimclick://kcbReq?code=[[QRCODE]]

카드사	URL
KB국민카드	intent://pay?srCode=[[QRCODE]]#Intent;scheme=kb-auth;package=com.kbcard.cxh.appcard;end
롯데카드	intent://lottecard/data?apptid=kcb&acctid=card&act=auth&de_seq=[[QRCODE]]#Intent;scheme=lotteappcard;package=com.lcacApp;end
비씨카드	intent://cardauth=[[QRCODE]]#Intent;scheme=ispmobile;package=kvp.jjy.MispAndroid320;end;
삼성카드	intent://xid=[[QRCODE]]#Intent;scheme=mpocket.online.ansimclick;package=kr.co.samsungcard.mpocket;end;
신한카드	intent://pay?srCode=[[QRCODE]]#Intent;scheme=shinhan-sr-ansimclick;package=com.shcard.smartpay;end;
하나카드	intent://?tid=[[QRCODE]]#Intent;scheme=cloudpay;package=com.hanaskcard.paycla;end;
현대카드	intent://identification?qr=[[QRCODE]]#Intent;scheme=hyundaicardappcardid;action=android.intent.action.VIEW;category=android.intent.category.BROWSABLE;package=com.hyundaicard.appcard;end;
NH농협카드	intent://kcbReq?code=[[QRCODE]]#Intent;scheme=nhallonepayansimclick;package=nh.smart.nhallonepay;end;