내통장 자동결제 키 발급 API
자동결제 등록(빌키 발급)을 위한 API입니다. 결제창 연동 후 인증 완료 시 호출하여 빌키를 발급받습니다.
테스트용 키 정보
API 정보
POST/APIRegularpayKey.do
Content-Type
application/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)
요청일자 (yyyyMMdd)
└reqTimeN(6)숫자, 최대 6byte*요청시간 (HH24MISS)
요청시간 (HH24MISS)
└signatureAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-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)
자동결제키 (BillKey)
└bankAcctNoAN(20)영문+숫자, 최대 20byte계좌번호 (마스킹)
123*****789계좌번호 (마스킹)
└bankCdAN(3)영문+숫자, 최대 3byte은행코드
011은행코드
API 테스트