내통장 자동결제 키 발급 API

자동결제 등록(빌키 발급)을 위한 API입니다. 결제창 연동 후 인증 완료 시 호출하여 빌키를 발급받습니다.

테스트용 키 정보


API 정보

POST/APIRegularpayKey.do
Content-Typeapplication/json; charset=UTF-8
테스트https://tbezauthapi.settlebank.co.kr/APIRegularpayKey.do
운영https://ezauthapi.settlebank.co.kr:8081/APIRegularpayKey.do

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
hdInfoAN(50)영문+숫자, 최대 50byte*
전문 정보 코드
*고정값
apiVerAN(4)영문+숫자, 최대 4byte*
전문 버전
*고정값
mercntIdAN(8)영문+숫자, 최대 8byte*
상점아이디
authNoAN(20)영문+숫자, 최대 20byte*
인증번호
reqDayN(8)숫자, 최대 8byte*
요청일자 (yyyyMMdd)
reqTimeN(6)숫자, 최대 6byte*
요청시간 (HH24MISS)
signatureAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA-256 해쉬값
NOTE

해쉬 생성 조합

mercntId + authNo + reqDay + reqTime + hashKey

응답 파라미터

resultCdN(1)숫자, 최대 1byte*0
결과코드
0: 성공 -1: 실패
errCdAN(5)영문+숫자, 최대 5byte*0000
실패코드
resultMsgAN(200)영문+숫자, 최대 200byte*성공
결과 메시지
mercntIdAN(8)영문+숫자, 최대 8byte*ms00003t
상점아이디
ordNoAN(100)영문+숫자, 최대 100byte*OID201902210001
주문번호
trNoAN(50)영문+숫자, 최대 50byte*STFP_PNPTms00001t00220922182409M1962430
거래번호
trDayN(8)숫자, 최대 8byte*20190221
거래일자
trTimeN(8)숫자, 최대 8byte*142120
거래시간
regularpayKeyAN(32)영문+숫자, 최대 32byte*
자동결제키 (BillKey)
bankAcctNoAN(20)영문+숫자, 최대 20byte123*****789
계좌번호 (마스킹)
bankCdAN(3)영문+숫자, 최대 3byte011
은행코드
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?