헥토파이낸셜 개발자센터

내통장 망취소 API

내통장결제 결제요청 후 가맹점 측에서 타임아웃 된 거래건에 대하여, 거래결과조회 API 응답상태가 '결제성공'일 경우 망취소를 요청하는 API입니다.

테스트용 키 정보

API 정보

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

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte

필수 파라미터

└hdInfoAN(50)영문+숫자, 최대 50byte*
전문 정보 코드
*고정값
└apiVerAN(4)영문+숫자, 최대 4byte*
전문 버전
*고정값
└mercntIdAN(8)영문+숫자, 최대 8byte*
헥토파이낸셜에서 부여하는 고유 상점아이디
└trDayN(8)숫자, 최대 8byte*
거래일자 (가맹점에서 주문시 생성한 거래일자)
└ordNoAN(100)영문+숫자, 최대 100byte*
가맹점에서 생성한 결제 주문번호
└reqDayN(8)숫자, 최대 8byte*
요청일자 (망취소 요청일자 yyyyMMdd)
└reqTimeN(6)숫자, 최대 6byte*
요청시간 (망취소 요청시간 HH24MISS)
└signatureAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA-256 방식으로 생성한 해쉬값
NOTE

해쉬 생성 조합

mercntId + ordNo + trDay + reqDay + reqTime + hashKey

응답 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└resultCdN(1)숫자, 최대 1byte*0
결과코드
0: 성공 -1: 실패
└errCdAN(5)영문+숫자, 최대 5byte*0000
실패코드 (실패코드 테이블 참조)
└resultMsgAN(200)영문+숫자, 최대 200byte*성공
결과 메시지
└apiVerAN(10)영문+숫자, 최대 10byte*1.0
API 버전

연동 예시 (JSON)

{
  "hdInfo": "IA_NC_1.0_1.0",
  "apiVer": "1.0",
  "mercntId": "ms00003t",
  "trDay": "20190221",
  "ordNo": "OID201902210001",
  "reqDay": "20190221",
  "reqTime": "142120",
  "signature": "SHA256해쉬값"
}
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?