헥토파이낸셜 개발자센터

결제 API

등록된 계좌를 통해 출금 결제를 요청하거나, 승인된 결제를 취소/환불합니다.

결제

등록된 계좌에서 출금이체를 실행하여 결제를 승인합니다.

API 정보

POST/v1/api/pay/confirm
Content-Typeapplication/json; charset=UTF-8
테스트https://tbnpay.settlebank.co.kr/v1/api/pay/confirm
운영https://npay.settlebank.co.kr/v1/api/pay/confirm

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*
상점아이디
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*
상점 주문번호 (한글 제외)
└mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
고객아이디
└reqDtAN(8)영문+숫자, 최대 8byte*
요청일자 (yyyyMMdd)
└reqTmAN(6)영문+숫자, 최대 6byte*
요청시간 (HH24MISS)
└trdAmtAN(13)영문+숫자, 최대 13byte*
결제 금액
└bankCdAN(3)영문+숫자, 최대 3byte*
출금은행코드 (등록된 은행코드)
└custAcntKeyAN(50)영문+숫자, 최대 50byte
계좌번호키 (출금이체 등록된 계좌의 식별키)
└splAmtN(13)숫자, 최대 13byte
공급가액
└vatN(13)숫자, 최대 13byte
부가세
└svcAmtN(13)숫자, 최대 13byte
봉사료
└pmtPrdtNmAN(100)영문+숫자, 최대 100byte
결제상품명 (한글 3byte)
└custAcntSumryAN(30)영문+숫자, 최대 30byte
통장인자내용 (한글 3byte)
└csrcIssReqYnA(1)영문, 최대 1byte
현금영수증 발행여부
Y: 발행 N: 미발행
└csrcIssPsblYnA(1)영문, 최대 1byte
현금영수증 발행가능 여부
Y: 가능 N: 불가능
└taxTypeCdA(1)영문, 최대 1byte
면세여부 (csrcIssReqYn Y 발행일 경우 필수)
Y: 면세 N: 과세
└csrcRegPrposYnN(1)숫자, 최대 1byte
현금영수증 용도구분 (csrcIssReqYn Y 발행일 경우 필수)
0: 소득공제 1: 지출증빙
└csrcRegNoDivCdN(1)숫자, 최대 1byte
현금영수증 발행정보 구분 (csrcIssReqYn Y 발행일 경우 필수)
1: 카드 2: 주민등록번호 3: 사업자등록번호 4: 휴대폰번호
└csrcRegNoAN(20)영문+숫자, 최대 20byteAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
현금영수증 발행정보 (csrcIssReqYn Y 발행일 경우 필수)
*csrcRegNoDivCd 값에 따른 실제값
└rglPmtYnA(1)영문, 최대 1byte
정기결제 여부 (Y 설정 시 정기결제 키 발급)
Y N
└rglEdDtAN(8)영문+숫자, 최대 8byte
정기결제 종료일 (yyyyMMdd)
└addDdtTypeCdA(1)영문, 최대 1byte
추가공제구분
Y: 대중교통 C: 도서, 공연비
└cupDepositAmtN(13)숫자, 최대 13byte
컵보증금 (거래금액에 포함)
└cmsCdAN(16)영문+숫자, 최대 16byte
추가인증고유번호
└custIpAN(15)영문+숫자, 최대 15byte
고객 IP 주소
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA-256 해쉬값
NOTE

해쉬 생성 조합

mchtId + mchtCustId + reqDt + reqTm + trdAmt(평문) + bankCd + hashKey

응답 파라미터

└outStatCdAN(4)영문+숫자, 최대 4byte*0021
거래상태코드
0021: 성공 0031: 실패
└outRsltCdAN(4)영문+숫자, 최대 4byte*0000
거절코드
└outRsltMsgAN(300)영문+숫자, 최대 300byte*정상처리되었습니다.
결과메시지
└trdNoAN(40)영문+숫자, 최대 40byte*STFP_FIRM12345678901234567890
거래번호 (취소 시 원거래번호로 사용)
└trdAmtN(13)숫자, 최대 13byte*1000
출금된 거래금액
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*OID201902210001
상점 주문번호
└rglChrgKeyAN(32)영문+숫자, 최대 32byteRGL_KEY_12345
정기결제키 (rglPmtYn='Y' 요청 시 발급)
└svcDivCdN(4)숫자, 최대 4byte*1
결제 시 사용된 서비스
1: 펌뱅킹
└custAcntNoAN(15)영문+숫자, 최대 15byte*234**********123
계좌번호 (마스킹 처리)
└macntNoAN(24)영문+숫자, 최대 24byteAES-256AES-256/ECB/PKCS5Padding
모계좌 번호
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?