내통장 자동결제 승인 API
발급받은 자동결제키(BillKey)를 사용하여 결제를 요청하는 API입니다.
테스트용 키 정보
API 정보
POST/v3/APIRegularPayment.do
Content-Type
application/json; charset=UTF-8테스트
https://tbezauthapi.settlebank.co.kr/v3/APIRegularPayment.do운영
https://ezauthapi.settlebank.co.kr:8081/v3/APIRegularPayment.do요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문 정보 코드
전문 정보 코드
*고정값
└apiVerAN(4)영문+숫자, 최대 4byte*전문 버전
전문 버전
*고정값
└mercntIdAN(8)영문+숫자, 최대 8byte*상점아이디
상점아이디
└trDayN(8)숫자, 최대 8byte*거래일자 (주문 시 생성한 거래일자)
거래일자 (주문 시 생성한 거래일자)
└trTimeN(6)숫자, 최대 6byte*거래시간 (주문 시 생성한 거래시간)
거래시간 (주문 시 생성한 거래시간)
└ordNoAN(100)영문+숫자, 최대 100byte*주문번호
주문번호
└reqDayN(8)숫자, 최대 8byte*요청일자 (yyyyMMdd)
요청일자 (yyyyMMdd)
└reqTimeN(6)숫자, 최대 6byte*요청시간 (HH24MISS)
요청시간 (HH24MISS)
└trPriceAN(13)영문+숫자, 최대 13byte*
AES-256AES-256/ECB/PKCS5Padding + Hex거래금액거래금액
└taxPriceAN(13)영문+숫자, 최대 13byte
AES-256AES-256/ECB/PKCS5Padding + Hex과세금액 (복합과세 시 필수)과세금액 (복합과세 시 필수)
└vatPriceAN(13)영문+숫자, 최대 13byte
AES-256AES-256/ECB/PKCS5Padding + Hex부가세금액 (복합과세 시 필수)부가세금액 (복합과세 시 필수)
└dutyFreePriceAN(13)영문+숫자, 최대 13byte
AES-256AES-256/ECB/PKCS5Padding + Hex면세금액 (복합과세 시 필수)면세금액 (복합과세 시 필수)
└containerDepositAN(5)영문+숫자, 최대 5byte
AES-256AES-256/ECB/PKCS5Padding + Hex자원순환보증금액 (대상 거래인 경우, 현금영수증 비대상)자원순환보증금액 (대상 거래인 경우, 현금영수증 비대상)
└productNmAN(95)영문+숫자, 최대 95byte*상품명
상품명
└dutyFreeYnA(1)영문, 최대 1byte*면세여부 (Y:면세, N:과세, G:복합과세)
면세여부 (Y:면세, N:과세, G:복합과세)
└criPsblYnA(1)영문, 최대 1byte현금영수증 발행가능 여부 (빈값일 경우 Y로 인식)
현금영수증 발행가능 여부 (빈값일 경우 Y로 인식)
Y: 발행가능 N: 발행불가능└addDeductionYnA(1)영문, 최대 1byte추가공제 구분
추가공제 구분
Y: 대중교통 C: 도서, 공연비 N: 추가공제없음└regularpayKeyAN(32)영문+숫자, 최대 32byte*자동결제키 (BillKey)
자동결제키 (BillKey)
└signatureAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 방식으로 생성한 해쉬값(실시간 생성)SHA-256 방식으로 생성한 해쉬값
NOTE
해쉬 생성 조합
mercntId + ordNo + trDay + reqDay + reqTime + trPrice(평문) + regularpayKey + hashKey
└custParam1AN(256)영문+숫자, 최대 256byte가맹점 추가필드 1 (거래조회시 응답전문에 표기)
가맹점 추가필드 1 (거래조회시 응답전문에 표기)
└custParam2AN(256)영문+숫자, 최대 256byte가맹점 추가필드 2 (거래조회시 응답전문에 표기)
가맹점 추가필드 2 (거래조회시 응답전문에 표기)
└custParam3AN(256)영문+숫자, 최대 256byte가맹점 추가필드 3 (거래조회시 응답전문에 표기)
가맹점 추가필드 3 (거래조회시 응답전문에 표기)
└custParam4AN(256)영문+숫자, 최대 256byte가맹점 추가필드 4 (거래조회시 응답전문에 표기)
가맹점 추가필드 4 (거래조회시 응답전문에 표기)
└payLimitCdAN(1)영문+숫자, 최대 1byte결제 한도 코드
결제 한도 코드
응답 파라미터
└resultCdN(1)숫자, 최대 1byte*결과코드
0결과코드
0: 성공 -1: 실패└errCdAN(5)영문+숫자, 최대 5byte*실패코드
0000실패코드
└resultMsgAN(200)영문+숫자, 최대 200byte*결과 메시지
성공결과 메시지
└trNoA(50)영문, 최대 50byte*헥토파이낸셜 거래번호
STFP_PNPTms00001t00220922182409M1962430헥토파이낸셜 거래번호
└ordNoAN(100)영문+숫자, 최대 100byte*주문번호
OID201902210001주문번호
└trPriceN(13)숫자, 최대 13byte*거래금액
15000거래금액
└discntPriceN(13)숫자, 최대 13byte*할인금액
1000할인금액
└payPriceN(13)숫자, 최대 13byte*결제금액
14000결제금액
└regularStatusA(1)영문, 최대 1byte자동결제 처리상태 (R: 재처리 필요, C: 해지 대상)
R자동결제 처리상태 (R: 재처리 필요, C: 해지 대상)
└criPriceN(13)숫자, 최대 13byte*현금영수증 발급 금액
13000현금영수증 발급 금액
└criTaxVatPriceN(13)숫자, 최대 13byte*현금영수증 과세 금액
11000현금영수증 과세 금액
└criDutyFreePriceN(13)숫자, 최대 13byte*현금영수증 비과세 금액
2000현금영수증 비과세 금액
└ordDayN(8)숫자, 최대 8byte*주문일자
20190221주문일자
└ordTimeN(6)숫자, 최대 6byte*주문시간
142120주문시간
└trDayN(8)숫자, 최대 8byte*거래일자 (yyyyMMdd)
20190221거래일자 (yyyyMMdd)
└trTimeN(6)숫자, 최대 6byte*거래시간 (HH24MISS)
142122거래시간 (HH24MISS)
API 테스트