내통장 결제승인 API
결제인증(UI)에서 받은 인증번호(authNo)를 사용하여 실제 출금을 진행하는 API입니다.
인증 유효시간
결제인증 완료 후 10분 이내에 결제승인 API를 호출해야 합니다. 10분 초과 시 인증 정보가 만료됩니다.
테스트용 키 정보
API 정보
POST/v3/APIPayApprov.do
Content-Type
application/json; charset=UTF-8테스트
https://tbezauthapi.settlebank.co.kr/v3/APIPayApprov.do운영
https://ezauthapi.settlebank.co.kr:8081/v3/APIPayApprov.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)
└custParam1AN(128)영문+숫자, 최대 128byte가맹점 추가필드 1 (거래내역 조회 시 리턴)
가맹점 추가필드 1 (거래내역 조회 시 리턴)
└custParam2AN(128)영문+숫자, 최대 128byte가맹점 추가필드 2 (거래내역 조회 시 리턴)
가맹점 추가필드 2 (거래내역 조회 시 리턴)
└custParam3AN(128)영문+숫자, 최대 128byte가맹점 추가필드 3 (거래내역 조회 시 리턴)
가맹점 추가필드 3 (거래내역 조회 시 리턴)
└custParam4AN(128)영문+숫자, 최대 128byte가맹점 추가필드 4 (거래내역 조회 시 리턴)
가맹점 추가필드 4 (거래내역 조회 시 리턴)
└signatureAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 방식으로 생성한 해쉬값(실시간 생성)SHA-256 방식으로 생성한 해쉬값
NOTE
해쉬 생성 조합
mercntId + authNo + reqDay + reqTime + hashKey
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└resultCdN(1)숫자, 최대 1byte*결과코드
0결과코드
0: 성공 -1: 실패└errCdAN(5)영문+숫자, 최대 5byte*실패코드 (실패코드 테이블 참조)
0000실패코드 (실패코드 테이블 참조)
└resultMsgAN(200)영문+숫자, 최대 200byte*결과 메시지
성공결과 메시지
└mercntIdAN(8)영문+숫자, 최대 8byte*헥토파이낸셜에서 부여하는 고유 상점아이디
ms00003t헥토파이낸셜에서 부여하는 고유 상점아이디
└ordNoAN(100)영문+숫자, 최대 100byte*가맹점 주문번호
ORDER20260107143000가맹점 주문번호
└trNoAN(50)영문+숫자, 최대 50byte*헥토파이낸셜 거래번호
STFP_PNPTms00001t00220922182409M1962430헥토파이낸셜 거래번호
└trPriceN(13)숫자, 최대 13byte*거래금액 (최초 결제 요청 금액)
15000거래금액 (최초 결제 요청 금액)
└discntPriceN(13)숫자, 최대 13byte*할인금액
1000할인금액
└payPriceN(13)숫자, 최대 13byte*결제금액 (최종 출금 금액)
14000결제금액 (최종 출금 금액)
└criPriceN(13)숫자, 최대 13byte*현금영수증 발급 금액 (현금성 결제 금액만 포함)
13000현금영수증 발급 금액 (현금성 결제 금액만 포함)
└criTaxVatPriceN(13)숫자, 최대 13byte*현금영수증 과세 금액 (부가세 포함)
11000현금영수증 과세 금액 (부가세 포함)
└criDutyFreePriceN(13)숫자, 최대 13byte*현금영수증 비과세 금액
2000현금영수증 비과세 금액
└trDayN(8)숫자, 최대 8byte*결제 승인 일자 (yyyyMMdd)
20190221결제 승인 일자 (yyyyMMdd)
└trTimeN(6)숫자, 최대 6byte*결제 승인 일시 (HH24MISS)
142120결제 승인 일시 (HH24MISS)
└regularpayKeyAN(32)영문+숫자, 최대 32byte자동결제키 (자동결제용 유니크 키)
자동결제키 (자동결제용 유니크 키)
└bankAcctNoAN(20)영문+숫자, 최대 20byte계좌번호 (마스킹)
123*****789계좌번호 (마스킹)
└bankCdAN(3)영문+숫자, 최대 3byte은행코드
011은행코드
요청 예시
{
"hdInfo": "IA_APPROV",
"apiVer": "3.0",
"mercntId": "ms00003t",
"authNo": "PAR20190220000000001",
"reqDay": "20260107",
"reqTime": "143000",
"custParam1": "",
"custParam2": "",
"custParam3": "",
"custParam4": "",
"signature": "6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b"
}
응답 예시
성공
{
"resultCd": "0",
"errCd": "0000",
"resultMsg": "성공",
"mercntId": "ms00003t",
"ordNo": "ORDER20260107143000",
"trNo": "STFP_PNPTms00001t00220922182409M1962430",
"trPrice": "15000",
"discntPrice": "1000",
"payPrice": "14000",
"criPrice": "13000",
"criTaxVatPrice": "11000",
"criDutyFreePrice": "2000",
"trDay": "20260107",
"trTime": "143025",
"bankCd": "011",
"bankAcctNo": "123*****789"
}
실패
{
"resultCd": "-1",
"errCd": "E1001",
"resultMsg": "인증번호가 유효하지 않습니다."
}
