실시간 1:1 그룹상담신청
상단으로 이동

KG이니시스

KG이니시스

계좌인증서비스

KG이니시스 API를 통해 계좌번호 검증, 예금주 확인, 1원 점유 인증이 가능한 서비스

Quick Guide

샘플 다운로드

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

리턴 URL 수정

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

테스트 실행 및 결과확인

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

실제 연동진행

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

연동 준비하기

계좌인증서비스 연동 전, 체크해야할 사항을 안내드립니다.

MID상점아이디
계약 완료 여부, 사용 설정 등은 계약담당자 문의
apiKey대칭키
가맹점관리자 ▶ 상점정보 ▶ 계약정보 ▶ KEY 정보 ▶ 부가서비스 연동 KEY 정보 ▶ 계좌인증서비스 ▶ [조회] 버튼 클릭

※ [조회] 버튼 미노출 시 계약담당자 문의

방화벽정보
항목 스테이징환경 운영환경
URL stgacctchk.inicis.com acctchk.inicis.com
IP 183.109.71.13 118.129.210.15
183.109.71.26
PORT 443
연결방향 OUTBOUND
프로토콜 TLS 1.2 이상 지원

STEP1계좌인증 요청

계좌인증 요청정보

  • 계좌인증 요청URL : https://acctchk.inicis.com/acctchk/v1/api/request
  • Content-Type : application/json;charset=utf-8
  • Method : POST
MID* 상점아이디
10 byte
reqSvcCd* 요청구분코드 ["01":성명조회, "02":실명조회, "03":점유인증]
점유인증 기준 동일 계좌번호로 하루 최대 5회 인증 가능
2 byte
mTxid* 가맹점 트랜잭션 ID (UTF-8 URLEncoding)
요청시마다 유일값, 최소길이:3
20 byte
timestamp* 요청 일시
YYYYMMDDHHmmss
14 byte
authHash* 등록된 가맹점 요청 확인을 위한 SHA256 hash 값
대상 : MID + mTxid + timestamp + apikey
apikey : 가맹점 계약 시 발급되는 키 값으로 계약 담당자에게 요청
mTxid : UTF-8 URLEncoding 후 사용 필수
HASH
N/A
flgUserName* 사용자 이름 입력 여부 (Y/N)
점유인증 요청 시 flgUserName : N 으로 요청
1 byte
userName 사용자 이름 (UTF-8 URLEncoding)
flgUserName: Y 일 경우 필수
입력 가능한 문자 : [한글] [영문] [숫자] [공백] [( )] [&] [/] [-] ['] [,] [.] [·]
N/A
userAcctNo* 사용자 계좌번호
flgFixedUser: Y 일 경우 필수
N/A
identifyNo 생년월일(YYYYMMDD) 또는 사업자번호
실명조회 시 필수
개인사업자/비사업자는 생년월일, 법인사업자의 경우 사업자번호 필수
10 byte
bankCd* 은행 코드
flgFixedUser: Y 일 경우 필수
은행코드
N/A
userHash 사용자 위변조방지를 위한 SHA256 hash 값
대상 : (userName) + MID + userAcctNo + mTxid + bankCd + timestamp
flgFixedUser: Y 인 경우 userName 필수
userName, mTxid : UTF-8 URLEncoding 후 사용 필수
HASH
N/A

STEP 2계좌인증 응답

※ 유의사항

  1. 정상처리 일 경우는 응답필드가 전부 전송됩니다.
  2. 처리결과에 따라 resultCode, resultMsg 이외의 값은 전송되지 않을 수 있습니다.
resultCode 결과코드
"0000":성공, 이외 실패
4 byte
resultMsg 결과메시지 (UTF-8 URLEncoding)
500 byte
authReqUrl 결과조회 요청 URL
이니시스 제공 URL이 맞는지 필수 검증 필요
200 byte
txid 계좌인증 트랜잭션 ID
고유값
40 byte
token 암호화 Token 값
Base64 Encoding
N/A

STEP 3인증확인 요청

결과조회 요청정보

  • 계좌인증확인 요청 URL : STEP2 계좌인증응답 수신 시 응답 된 authReqUrl
  • Method : POST
  • 계좌인증 결과조회는 반드시 HTTPS( SERVER to SERVER ) 로 통신해야 합니다.
  • Content-Type : application/json;charset=utf-8
MID* 상점아이디
10 byte
txid* 계좌인증 트랜잭션 ID
STEP2 계좌인증응답으로 수신받은 값
40 byte
authNo 점유인증 시 사용자 입력 검증값
N/A

STEP 4인증확인 응답

※ 유의사항

해당 응답파라미터는 모든 인증 프로세스 종료 후 최종적으로 전달되는 응답파라미터 입니다.

  1. 정상처리 일 경우는 응답필드가 전부 전송됩니다.
  2. 처리결과에 따라 resultCode, resultMsg 이외의 값은 전송되지 않을 수 있습니다.
resultCode* 결과코드
"0000":성공, "0001":부분성공, "0002":부분성공 이외 실패
N/A
resultMsg* 결과메세지 (UTF-8 urlEncoding)
N/A
txid 계좌인증 트랜잭션 ID
N/A
svcCd 요청구분코드
N/A
userName 사용자 이름
SEED 암호화
복호화
N/A
acctNm 계좌주 성명
SEED 암호화
복호화
N/A
acctNo 계좌번호
SEED 암호화
복호화
N/A
bankCd 은행코드
은행코드
N/A

CODE결과 코드

결과코드 결과메세지 비 고
0000정상처리되었습니다.
0001정상처리되었습니다. (성명비교검증 부분성공)
0002정상처리되었습니다. (성명비교검증 부분성공)
0003실패한 계좌인증입니다.
0004존재하지 않는 계좌인증 결과입니다.
0005이미 조회된 계좌인증 결과입니다.
0006계좌인증 결과 데이터 요청중 에러가 발생했습니다.관리자 문의 필요
0007알 수 없는 요청 URL입니다.
0008계좌인증 결과조회 가능 시간이 초과되었습니다.제한시간 5분
0101txid 와 MID가 일치 하지 않습니다.
0102기준정보 MPI 통신 연결에 실패했습니다.관리자 문의 필요
0103DB 처리중 오류가 발생했습니다.관리자 문의 필요
0104이용 가능한 중계사가 없습니다.관리자 문의 필요
3001인증번호가 존재하지 않습니다.
3002인증번호가 일치하지 않습니다.
3003성명 비교 검증에 실패했습니다.
40001일 인증 횟수를 초과하였습니다.1일 인증 횟수: 5회
1000잘못된 API KEY로 요청되었습니다.
1001잘못된 이용기관 코드입니다.
2001정의되어 있지 않은 요청 파라미터입니다.
2002필수 데이터가 누락되었습니다.
3000은행장애 또는 은행 점검시간입니다.
VTIM은행 또는 인증기관으로부터 응답이 없습니다.
0011요청에 대한 처리가 완료되지 않았습니다.
DSYS시스템 오류가 발생했습니다.
DETC기타 오류(미정의 오류코드)가 발생했습니다.
DTIM요청 시간이 초과되었습니다.
DDBEDB 에러가 발생했습니다.
D001필수값 오류가 발생했습니다.
D002기관정보 오류가 발생했습니다.
D003기관은행정보 조회 오류가 발생했습니다.
D004 기관 미활동 상태입니다.
D005 기관 장애중 상태입니다.
D006기관 시스템 상태 오류가 발생했습니다.
D007기관 거래번호 채번 오류가 발생했습니다.
D008기관 거래번호 채번 오류가 발생했습니다.
D009상위기관 기관시스템상태 오류가 발생했습니다.
D010상위기관 미활동 상태입니다.
D011상위기관 장애중 상태입니다.
D012상위기관 거래번호 채번 오류가 발생했습니다.
D013전문항목 오류가 발생했습니다.
D014은행코드 오류가 발생했습니다.
D015응답코드 공백이 발생했습니다.
D016응답코드 설정이상 발생했습니다.
D017기관 거래번호 중복이 발생했습니다.
D018송수신구분 코드 오류가 발생했습니다.
D019코드상세 내역이 없습니다.
D020기타 오류입니다.
D021밸런싱내역이 없습니다.
D022은행 점검중입니다.
D023사용불가 전문입니다.
D024주문번호 중복입니다.
D025미등록 변환코드입니다.
D026전문코드 매핑 오류가 발생했습니다.
D027전문 변환 오류가 발생했습니다.
D028거래코드 이상이 발생했습니다.
D029내역 없음 오류가 발생했습니다.
D030장애 FLAG 오류가 발생했습니다.
D031거래금액 오류가 발생했습니다.
D032고객계좌관리정보가 없습니다.
D033기관모계좌정보가 없습니다.
D034등록해지구분코드 오류가 발생했습니다.
D035은행기관코드 검증오류가 발생했습니다.
D036금결원기관코드 검증오류가 발생했습니다.
D037송금불능 거래번호가 누락이 발생했습니다.
D038송금불능일자 누락이 발생했습니다.
D039명세일자 누락이 발생했습니다.
D040주문번호 조회오류가 발생했습니다.
D041존재하지 않는 계좌입니다.
D042유효하지 않는 계좌입니다.
D043이중출금 발생했습니다.
D044통신 장애가 발생했습니다.
D045이미 등록된 계좌입니다.
D046유효하지 않는 요청전문입니다.
D047출금계좌 잔액이 부족합니다.
D048ARS 인증 결과가 없습니다.
D049ARS 인증 요청 값이 상이합니다.
D050자동이체 해지 계좌입니다.
D051계좌 거래 제한이 발생했습니다.
D052주민번호 사업자번호 오류가 발생했습니다.
D053계좌오류(간편계좌등록불가)가 발생했습니다.
D054기타 거래 불가 오류가 발생했습니다.
D055계좌 오류가 발생했습니다.
D056수취인 계좌가 없습니다.
D057법적 제한 계좌입니다.
D058비실명 계좌입니다.
D059예금주가 불일치합니다.
D060이미 취소된 거래입니다.
D061취소금액 오류가 발생했습니다.
D062ARS 인증 실패했습니다.
D063ARS 수신불가합니다.
D064계좌 등록 진행중입니다.
D065환불 진행중입니다.
D066이중송금이 발생했습니다.
D067납부자 성명조회가 실패했습니다.
D0681회 한도초과입니다.
D0691일 한도초과입니다.
D070사고계좌입니다.
D071일정시간이 지나 연결이 끊어졌습니다.
D072간편결제 취소가 발생했습니다.
D073요청 진행 중입니다.
D074환불 중복 요청이 있습니다.
D075처리 중 요청이 있습니다.
D076서비스 용량 초과입니다.
D077시스템 BUSY 발생했습니다.
D078이미 등록된 현금영수증 사용자입니다.
D079미등록 현금영수증 사용자입니다.
D080거래가 실패했습니다.
D081월 한도 금액초과입니다.
D082일 한도 건수초과입니다.
D083월 한도 건수초과입니다.
D084간편결제 시스템 점검중입니다.
D085해당 은행 및 업체 장애가 발생했습니다.
D086납부자번호 오류가 발생했습니다.
D087조회일자 오류가 발생했습니다.
D088원거래전문번호 오류가 발생했습니다.
D089조회구분코드 오류가 발생했습니다.
D090전송일자와 현재일자가 불일치합니다.
D091업무 개시전입니다.
D092기처리 거래입니다.
D093이중신청거래입니다.
D094원거래 없습니다.
D095원거래 오류가 발생했습니다.
D096휴일 거래 불가입니다.
D097거래 중지 계좌입니다.
D098거래 가능 시간 아닙니다.
D099처리 지연이 발생했습니다.
D100거래 일자 오류가 발생했습니다.
D101취소불가 발생했습니다.
D102해지계좌입니다.
D103자동이체미신청계좌입니다.
D104복기부호오류가 발생했습니다.
D105CMS오류가 발생했습니다.
D106비밀번호가 상이합니다.
D107업무종료 했습니다.
D108계정처리가 불가합니다.
D109한도초과입니다.
D110성명오류가 발생했습니다.
D111수표관련오류가 발생했습니다.
D112조회불가일자입니다.
D113취소오류가 발생했습니다.
D114어음오류가 발생했습니다.
D115처리불가합니다.
D116처리중 오류가발생 발생했습니다.
D117일자오류가 발생했습니다.
D118결번전문번호 오류가 발생했습니다.
D119주문번호가 없습니다.
D120통화코드오류가 발생했습니다.
D121인증유효기간이 만료되었습니다.
D122취소완료됐습니다.
D123지로 결제원응답코드 오류가 발생했습니다.
D124계좌ID 중복입니다.
D125환율고시중입니다.
D126분실계좌입니다.
D127시나리오 코드 오류가 발생했습니다.
D128하위기관코드 미등록 상태입니다.
D129타행 업무 개시전입니다.
D130은행 처리실패입니다.
D131하위기관코드 검증오류가 발생했습니다.
D132기타 거래 불가(당행)입니다.
D133법적 제한 계좌(당행)입니다.
D134해지계좌(당행)입니다.
D135하위기관코드 기등록 상태입니다.
D136거래 중지 계좌(당행)입니다.
D137별단출금 금액이 불일치합니다.
D138점유인증 검증값이 불일치합니다.
D139점유인증 유효횟수 초과됐습니다.
D140타행이체 불능 발생했습니다.
D141ACH라우팅매핑정보가 없습니다.
D142조회불가 요청은행(미계약)입니다.
D143신원확인번호가 미입력됐습니다.
D144생년월일 체크결과 미성년자에 해당됩니다.
DPRC더즌 기처리 전문입니다.
0031인증에 실패하였습니다.
ST01존재하지 않는 계좌입니다.
ST02유효하지 않는 계좌입니다.
ST03이중 출금이 발생했습니다.
ST04VAN 요청중 시스템 에러가 발생했습니다.
ST05VAN 응답정보가 없습니다.
ST06거래번호 정보가 존재하지 않습니다.
ST07통신장애가 발생했습니다.
ST08이미 등록된 계좌입니다.
ST09유효하지 않는 요청입니다.
ST10내부 시스템 에러가 발생했습니다.
ST11은행점검 시간입니다.
ST12출금계좌 잔액이 부족합니다.
ST13ARS 인증 결과가 존재하지 않습니다.
ST14ARS 인증코드가 일치하지 않습니다
ST15자동이체 서비스 해지 계좌입니다.
ST16거래제한된 출금계좌입니다.
ST17주민번호 또는 사업자번호가 오류입니다.
ST18간편계좌 등록이 불가능한 계좌입니다.
ST19거래가 불가능한 계좌입니다.
ST20계좌 오류가 발생했습니다.
ST21수취인 계좌가 존재하지 않습니다.
ST22법적 제한된 계좌입니다.
ST23비실명 계좌입니다.
ST24예금주가 일치하지 않습니다.
ST25이미 취소된 거래입니다.
ST26취소금액 오류가 발생했습니다.
ST27ARS 인증이 실패했습니다.
ST28ARS 수신이 불가능합니다.
ST29계좌 등록이 진행중입니다.
ST30환불 진행중입니다.
ST31이중송금이 발생했습니다.
ST32납부자 성명조회에 실패했습니다.
ST331회 한도초과입니다.
ST341일 한도초과입니다.
ST35사고등록계좌입니다.
ST36시간 초과로 연결이 끊어졌습니다.
ST37간편결제가 취소되었습니다.
ST38요청이 진행중입니다.
ST39환불이 중복해서 요청되었습니다.
ST40중복 요청이 발생했습니다.
ST41서비스 허용량이 초과되었습니다.
ST42시스템 과부화 오류가 발생했습니다.
ST43이미 등록된 계좌입니다.
ST44거래 불가능한 은행입니다.
ST50중복된 요청입니다.
ST51이미 등록된 현금영수증 사용자입니다.
ST52미등록된 현금영수증 사용자입니다.
ST53이미 해지된 계좌입니다.
ST60거래에 실패하였습니다.
ST611회 한도 금액을 초과하였습니다.
ST62일 한도 금액을 초과하였습니다.
ST63월 한도 금액을 초과하였습니다.
ST64일 한도 건수를 초과하였습니다.
ST65월 한도 건수를 초과하였습니다.
ST66비밀번호 등록에 실패하였습니다.
ST67비밀번호가 일치하지 않습니다.
ST68서비스 이용이 정지되었습니다.
ST69정책상 해당 결제서비스 이용이 불가능합니다.
다른 결제수단으로 이용 바랍니다.
ST70정책상 선택하신 결제서비스 이용이 불가능합니다.
헥토파이낸셜 고객센터로 문의해 주세요. (1600-5220)
ST72ARS 2차 인증이 필요합니다.
ST75잘못된 정보로 여러 번 시도하여 계좌이용이 불가능합니다.
익일 재시도하시길 바랍니다.
ST76잘못된 정보로 여러 번 시도하여 계좌이용이 불가능합니다.
익일 재시도하시길 바랍니다.
ST86휴대폰 본인 인증에 실패하였습니다.
ST87간편본인확인 미가입 사용자입니다.
VTIM요청 시간이 초과되었습니다. 관리자 문의 필요
ST99간편결제 시스템 점검중입니다.
SE01인증 유효시간이 만료되었습니다.
SE02인증 번호가 일치하지 않습니다.
9100필수 요청 값이 누락되었습니다.
9101데이터 사이즈 오류입니다.
9102데이터가 올바르지 않습니다.
9103이용할 수 없는 은행입니다.
9105기준정보 조회에 실패했습니다.관리자 문의 필요
9106중복된 거래입니다. 개발자에게 문의해주세요.
9109사용할 수 없는 요청구분 입니다.
9110비정상적인 접근입니다. 처음부터 다시 시도하여 주십시오.
9200일시적 네트워크 오류가 발생했습니다. 관리자 문의 필요
9201요청 서버에 오류가 발생했습니다. 관리자 문의 필요
9202네트워크 연결중 오류가 발생했습니다. 관리자 문의 필요
9300중계사 통신 연결에 실패했습니다. 관리자 문의 필요
9996비정상적인 접근입니다. 처음부터 다시 시도하여 주십시오.
9997URL Redirect 과정중 오류가 발생했습니다. 관리자 문의 필요
9998처리중 오류가 발생하였습니다. 관리자 문의 필요
9999기타 오류입니다.