이용기관 서버에서 kakaoCert로 인증요청 함수를 호출하면 이용자의 카카오톡으로 인증 메시지를 전송하여 확인 후 인증을 진행하는 방식입니다.
이용기관 App에서 카카오톡 App 인증 *앱스킴을 호출해 카카오톡 App을 즉시 실행하여 이용자의 인증 메시지 확인 없이 인증을 진행하는 방식입니다.
* 모바일 애플리케이션 및 브라우저에서 카카오톡 혹은 이용기관 앱을 실행시키는 앱스킴을 의미합니다.
kakaotalk://kakaopay/cert/sign?tx_id={tx_id}&success={appscheme1}&fail={appscheme2}
Parameter
Name | Type | Description |
---|---|---|
tx_id | String | 카카오톡 App 인증 앱스킴을 호출하기 위한 카카오톡 트랜잭션아이디 |
success | String | 서명 성공 후 카카오톡에서 호출할 이용기관 앱의 앱스킴을 URL 인코딩한 값 |
fail | String | 서명 실패 후 카카오톡에서 호출할 이용기관 앱의 앱스킴을 URL 인코딩한 값 |
Example
서명 성공(success) 호출해야 하는 이용기관 앱스킴 : paytest://cert/success
서명 실패(fail) 호출해야 하는 이용기관 앱스킴 : paytest://cert/fail
tx_id : d3c57x08c2c97590ay23d6f6940e7815
kakaotalk://kakaopay/cert/sign?tx_id=d3c57x08c2c97590ay23d6f6940e7815&success=paytest%3A%2F%2Fcert%2Fsuccess&fail=paytest%3A%2F%2Fcert%2Ffail
Parameter
Name | Description | Remark |
---|---|---|
tx_id | 카카오톡 트랜잭션아이디 | 필수 |
signature | * 서명값(signature) | 성공하는 경우 전달(Android) |
code | 에러 코드 | 실패하는 경우 전달(iOS 성공하는 경우에도 값 : 0 리턴) |
Example
서명 성공(success) 앱스킴 : paytest://cert/success
tx_id : d3c57x08c2c97590ay23d6f6940e7815
paytest://cert/success?tx_id=d3c57x08c2c97590ay23d6f6940e7815&signature=abcdefg
서명 실패(fail) 앱스킴 : paytest://cert/fail
tx_id : d3c57x08c2c97590ay23d6f6940e7815
code : 1000 (하단 에러코드 참고)
paytest://cert/fail?tx_id=d3c57x08c2c97590ay23d6f6940e7815&code=1000
에러코드
Code | Description |
---|---|
1000 | 약관에 동의하지 않음 |
1001 | 휴대폰 본인인증 중 이용자가 취소함 |
1002 | 계좌점유 확인 중 이용자가 취소함 |
1003 | 카카오머니 비밀번호 확인 중 이용자가 취소함 |
1004 | 인증 비밀번호 등록 중 이용자가 취소함 |
2000 | 이용자 상태 체크 실패 |
2001 | CI중복 상태 |
3000 | 인증서 발급 요청 실패 |
3001 | 이용기관 등록 실패 |
4000 | 서명 요청 실패 |
4001 | 서명 요청 유효성 검증 실패 |
4002 | 인증서 상태가 유효하지 않음 |
4003 | 서명 데이터 요청 실패 |
4004 | 서명 원문 확인시 이용자가 취소함 |
4005 | 브릿지 화면에서 이용자가 취소함 |
4006 | 인증 비밀번호를 5회 잘못 입력함 |
4007 | 개인키 로드 실패 |
4008 | 인증 비밀번호 화면에서 이용자가 취소함 |
4009 | 서명 확인 실패 |
4010 | 서명 프로세스 중, 사용자 취소 |
5000 | 강제 종료 |
5001 | 보안키패드 라이브러리 오류 |
기술지원센터
kakaoCert 기술지원은 유선, 메일, 원격지원 등 다양한 채널을 통해 제공됩니다.
T. 1600-9854E. code@linkhubcorp.com
Copyright (C) LinkHub. All Rights Reserved.