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


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


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


테스트 실행 및 결과확인
인증 진행과정과
응답결과를 확인해 주세요.

실제 연동진행
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
연동 준비하기
카드본인확인서비스 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 인증서 등은 계약담당자 문의SEED암호화대칭키
카드본인확인 계약 시 안내받은 SEED암호화 key, iv 사용방화벽정보
항목 | 스테이징환경 | 운영환경 |
---|---|---|
URL | stgcas.inicis.com | cas.inicis.com |
IP | 183.109.71.158 | 118.129.210.83 183.109.71.85 |
PORT | 443 | |
연결방향 | OUTBOUND |
STEP1카드 본인인증 요청
※ 유의사항
카드본인확인서비스 연동 시 유의할 사항에 대하여 안내드립니다.
유의사항을 준수하지 않음으로 인해 발생되는 문제에 대하여는 당사에서 책임지지 않습니다.
- 카드본인확인서비스는 반드시 HTTPS 로 통신해야 합니다.
- 인증창 호출은 POP-UP 방식이 기본입니다.
- 모바일 연동 시 유의사항
- 일반적인 모바일웹 환경은 연동규격이 동일합니다.
- 가맹점 앱 내 웹뷰(WebView) 연동 시, 팝업창 호출에 제한이 있으므로 페이지 전환방식으로 연동바랍니다.
- 웹뷰(WebView) 연동 시 스크립트가 작동하지 않으므로, Closeurl 을 설정하여 해당페이지로 이동할 수 있도록 작업해주시기 바랍니다.
(취소버튼 or 닫기버튼 클릭 시 사용)
카드본인확인 요청정보
- 인증요청URL : https://cas.inicis.com/casapp/ui/cardauthreq
- Content-Type : application/x-www-form-urlencoded;charset=utf-8
- HTTP Method : POST
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
|
STEP 2카드 본인인증 응답
※ 유의사항
- 정상처리 (Resultcd:0000) 일 경우는 응답필드가 전부 전송됩니다.
- 실패일 경우 Mac 값은 전송되지 않습니다.
- 처리결과에 따라 Resultcd, Resultmsg 이외의 값은 전송되지 않을 수 있습니다.
- 카드 본인인증 요청 결과의 Tradeid 와 카드 본인인증 응답 결과의 Tradeid 가 일치하는지 확인하여 불일치 시 오류처리 하십시오.
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
|
EDD앱스킴 URL
카드본인확인서비스를 가맹점앱 내 웹뷰로 연동할 경우 참고할 수 있는 카드사별 앱스킴URL 을 안내합니다.
iOS 앱스킴 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
카드사 | 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; |