헥토파이낸셜 개발자센터
Products서비스
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
API & SDKAPI & SDK
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그블로그
FAQFAQ
서비스 상태
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그
기술 블로그 및 소식
FAQ
자주 묻는 질문
서비스 상태
서비스 장애 및 점검 현황
PG 결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우노티(notiUrl) 연동결제 취소 및 환불운영 전환
결제창 연동JavaScript SDKFORM-SUBMIT
신용카드 표준 결제창신용카드 결제창 (직호출)신용카드 노티 전문신용카드 승인 (인증분리)신용카드 카드등록 (빌키발급 결제창)신용카드 빌키 결제신용카드 빌키 삭제신용카드 취소
계좌이체 결제창계좌이체 노티 전문계좌이체 승인 (인증분리)계좌이체 취소
가상계좌 결제창가상계좌 노티 전문가상계좌 채번가상계좌 채번 (고정식 무제한)가상계좌 채번정보 변경가상계좌 채번취소가상계좌 수취 조회가상계좌 환불가상계좌 입금테스트
010 가상계좌 개요010가상계좌 결제창휴대폰 점유 인증 요청휴대폰 인증 확인동일 금액 확인010가상계좌 채번010가상계좌 채번취소010가상계좌 환불010가상계좌 노티010가상계좌 입금테스트
휴대폰 결제창휴대폰결제 노티 전문휴대폰 승인 (하이브리드)휴대폰 자동결제휴대폰결제 취소휴대폰결제 환불
상품권 결제창상품권 노티 전문상품권 취소
티머니 결제창티머니 노티 전문티머니 취소
포인트다모아 결제창포인트다모아 노티 전문포인트다모아 승인 (인증/승인 분리)포인트다모아 취소
간편결제 개요페이코 결제창페이코 테스트 환경삼성페이 결제창카카오페이 결제창네이버페이 결제창토스페이 결제창간편결제 노티 전문간편결제 취소간편 정기결제간편 정기결제 상태조회간편 정기결제 키삭제
실시간 거래 조회영수증(매출전표) 조회 (무인증)영수증(매출전표) 조회 (인증)거래대사정산대사2차 이하 PG하위사업자 정보 등록영중소사업자 차액정산영중소사업자 환급정산
에러 코드카드사 코드금융기관 코드결제수단 코드가상계좌 은행 코드
내통장결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창 연동
내통장 결제인증내통장 결제승인내통장 결제취소내통장 망취소
내통장 거래결과조회내통장 거래내역조회현금영수증 조회
내통장 자동결제 키 발급내통장 자동결제 승인내통장 자동결제 해지
에러 코드금융기관 코드은행 점검시간
간편현금결제
연동 준비하기서버 및 네트워크 정보펌뱅킹 연동 플로우
휴대폰 본인인증 요청휴대폰 본인인증 확인예금주성명조회Ⅰ예금주성명조회Ⅱ예금주성명조회 (금액포함)계좌점유인증계좌점유인증 요청계좌점유인증 확인ARS 인증 요청ARS 인증 확인계좌점유인증 내역 조회결제비밀번호 확인
계좌 등록계좌 해지가맹점 자체 계좌 등록금융결제원 출금이체정보 해지 조회
결제결제 취소/환불송금송금계좌 잔액 조회
정기결제 키 발행정기결제 승인정기결제 해지정기결제 정보 조회정기결제 거래내역 조회
거래 결과 조회거래 내역 조회계좌 목록 조회은행 목록 조회은행 점검 조회계좌점유인증 은행점검조회테스트콜
연동 준비하기서버 및 네트워크 정보오픈뱅킹 연동 플로우
계좌 등록오픈뱅킹 계좌등록오픈뱅킹 서비스해지
결제결제 취소송금
자금반환청구 요청자금반환청구 확인
거래 결과 조회거래내역조회계좌목록조회출금이체한도 조회
거절코드표금융기관코드표은행 점검시간
화이트라벨
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창결제 승인결제 취소
조회
에러 코드금융기관 코드은행 점검시간
현금영수증
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
현금영수증 등록현금영수증 취소
현금영수증 발급오류내역 조회현금영수증 발급상태 조회
현금영수증 재처리 등록현금영수증 재처리 결과내역 조회
참고
실시간 펌뱅킹
연동 준비하기전체 연동 플로우
관리전문
당타행 지급이체집금(수납) 이체수납출금계좌 등록/해지일반지준이체 (SC은행)특정금전신탁 입지급 (우리은행)
타행이체불능통지예금거래명세통지어음명세통지어음명세결번일반지준이체결과통지 (SC은행)타행이체불능통지결번예금거래명세통지결번
계좌성명조회이체처리결과조회잔액조회일반지준이체결과조회 (SC은행)자동이체결과조회 (SC은행 전용)
자금이체집계집금이체집계통지현황
관리전문
외화송금의뢰외화송금의뢰취소외화송금결과통지외화송금결과통지 결번외화송금의뢰(MX)외화송금결과통지(MX)외화송금결과통지결번(MX)
국내 외화 당행 예금주명조회국내 외화 예금주명 조회환율정보거래환율정보거래(외환은행)외화 송금처리결과 조회외화잔액조회
외화송금집계외화자동이체집계외화당행송금집계
외화입출금거래명세통지외화입출금거래명세통지 결번
VAN 가상계좌
VAVS 시작하기통신 및 전문 구성전문 공통부
수취조회 (2000/2100)입금 및 취소
송금 (6010/6110)예치금 잔액조회 (6001/6101)
요약전문
성명조회 (2001/2101)실입금자명 통보 (1030/1130)실입금자명 파일 통보실입금자명 결번요청 (1033/1133)출금계좌등록 (5080/5180)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트
PG 결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우노티(notiUrl) 연동결제 취소 및 환불운영 전환
결제창 연동JavaScript SDKFORM-SUBMIT
신용카드 표준 결제창신용카드 결제창 (직호출)신용카드 노티 전문신용카드 승인 (인증분리)신용카드 카드등록 (빌키발급 결제창)신용카드 빌키 결제신용카드 빌키 삭제신용카드 취소
계좌이체 결제창계좌이체 노티 전문계좌이체 승인 (인증분리)계좌이체 취소
가상계좌 결제창가상계좌 노티 전문가상계좌 채번가상계좌 채번 (고정식 무제한)가상계좌 채번정보 변경가상계좌 채번취소가상계좌 수취 조회가상계좌 환불가상계좌 입금테스트
010 가상계좌 개요010가상계좌 결제창휴대폰 점유 인증 요청휴대폰 인증 확인동일 금액 확인010가상계좌 채번010가상계좌 채번취소010가상계좌 환불010가상계좌 노티010가상계좌 입금테스트
휴대폰 결제창휴대폰결제 노티 전문휴대폰 승인 (하이브리드)휴대폰 자동결제휴대폰결제 취소휴대폰결제 환불
상품권 결제창상품권 노티 전문상품권 취소
티머니 결제창티머니 노티 전문티머니 취소
포인트다모아 결제창포인트다모아 노티 전문포인트다모아 승인 (인증/승인 분리)포인트다모아 취소
간편결제 개요페이코 결제창페이코 테스트 환경삼성페이 결제창카카오페이 결제창네이버페이 결제창토스페이 결제창간편결제 노티 전문간편결제 취소간편 정기결제간편 정기결제 상태조회간편 정기결제 키삭제
실시간 거래 조회영수증(매출전표) 조회 (무인증)영수증(매출전표) 조회 (인증)거래대사정산대사2차 이하 PG하위사업자 정보 등록영중소사업자 차액정산영중소사업자 환급정산
에러 코드카드사 코드금융기관 코드결제수단 코드가상계좌 은행 코드
내통장결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창 연동
내통장 결제인증내통장 결제승인내통장 결제취소내통장 망취소
내통장 거래결과조회내통장 거래내역조회현금영수증 조회
내통장 자동결제 키 발급내통장 자동결제 승인내통장 자동결제 해지
에러 코드금융기관 코드은행 점검시간
간편현금결제
연동 준비하기서버 및 네트워크 정보펌뱅킹 연동 플로우
휴대폰 본인인증 요청휴대폰 본인인증 확인예금주성명조회Ⅰ예금주성명조회Ⅱ예금주성명조회 (금액포함)계좌점유인증계좌점유인증 요청계좌점유인증 확인ARS 인증 요청ARS 인증 확인계좌점유인증 내역 조회결제비밀번호 확인
계좌 등록계좌 해지가맹점 자체 계좌 등록금융결제원 출금이체정보 해지 조회
결제결제 취소/환불송금송금계좌 잔액 조회
정기결제 키 발행정기결제 승인정기결제 해지정기결제 정보 조회정기결제 거래내역 조회
거래 결과 조회거래 내역 조회계좌 목록 조회은행 목록 조회은행 점검 조회계좌점유인증 은행점검조회테스트콜
연동 준비하기서버 및 네트워크 정보오픈뱅킹 연동 플로우
계좌 등록오픈뱅킹 계좌등록오픈뱅킹 서비스해지
결제결제 취소송금
자금반환청구 요청자금반환청구 확인
거래 결과 조회거래내역조회계좌목록조회출금이체한도 조회
거절코드표금융기관코드표은행 점검시간
화이트라벨
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창결제 승인결제 취소
조회
에러 코드금융기관 코드은행 점검시간
현금영수증
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
현금영수증 등록현금영수증 취소
현금영수증 발급오류내역 조회현금영수증 발급상태 조회
현금영수증 재처리 등록현금영수증 재처리 결과내역 조회
참고
실시간 펌뱅킹
연동 준비하기전체 연동 플로우
관리전문
당타행 지급이체집금(수납) 이체수납출금계좌 등록/해지일반지준이체 (SC은행)특정금전신탁 입지급 (우리은행)
타행이체불능통지예금거래명세통지어음명세통지어음명세결번일반지준이체결과통지 (SC은행)타행이체불능통지결번예금거래명세통지결번
계좌성명조회이체처리결과조회잔액조회일반지준이체결과조회 (SC은행)자동이체결과조회 (SC은행 전용)
자금이체집계집금이체집계통지현황
관리전문
외화송금의뢰외화송금의뢰취소외화송금결과통지외화송금결과통지 결번외화송금의뢰(MX)외화송금결과통지(MX)외화송금결과통지결번(MX)
국내 외화 당행 예금주명조회국내 외화 예금주명 조회환율정보거래환율정보거래(외환은행)외화 송금처리결과 조회외화잔액조회
외화송금집계외화자동이체집계외화당행송금집계
외화입출금거래명세통지외화입출금거래명세통지 결번
VAN 가상계좌
VAVS 시작하기통신 및 전문 구성전문 공통부
수취조회 (2000/2100)입금 및 취소
송금 (6010/6110)예치금 잔액조회 (6001/6101)
요약전문
성명조회 (2001/2101)실입금자명 통보 (1030/1130)실입금자명 파일 통보실입금자명 결번요청 (1033/1133)출금계좌등록 (5080/5180)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트

가상계좌 수취 조회 API

PG사에서 수취조회를 하지 않고 가맹점에서 직접 유효성 검증을 수행하는 방식입니다. 고객이 입금하기 전에 헥토파이낸셜에서 가맹점으로 수취 조회 요청을 전송하고, 가맹점에서 유효성을 확인한 후 응답합니다.

가맹점 수취조회 서비스 신청 필수

가맹점 수취조회 기능은 별도 신청이 필요합니다. 영업담당자를 통해 서비스 신청 후 사용 가능합니다.
NOTE

수취조회 수신 URL

수취조회·P수취조회 요청은 상점 기준정보에 등록한 수취조회 전용 URL로 전송됩니다. 입금·채번 노티를 받는 노티 URL과 별도이며, 서비스 신청 시 함께 등록합니다. 노티 수신 URL 기준 보기

수취 조회 흐름

구매자
은행
헥토파이낸셜
가맹점
11. 입금 시도
1. 입금 시도
22. 수취 조회 요청
2. 수취 조회 요청
33. 수취 조회 전문 전송
3. 수취 조회 전문 전송
44. 유효성 검증 결과 응답
4. 유효성 검증 결과 응답
55. 수취 조회 결과 전달
5. 수취 조회 결과 전달
66. 입금 처리 (성공 시)
6. 입금 처리 (성공 시)

통신 규격

구분내용
요청 방향헥토파이낸셜 → 가맹점
응답 방향가맹점 → 헥토파이낸셜
전송 방식POST
요청 Content-Typeapplication/x-www-form-urlencoded; charset=UTF-8
응답 Content-Typeapplication/json
인코딩UTF-8 기본 (EUC-KR로 수신한 경우 동일한 인코딩으로 응답)

요청 파라미터 (헥토파이낸셜 → 가맹점)

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

헥토파이낸셜 서버에서 가맹점으로 요청하는 파라미터입니다.

└methodA(2)영문, 최대 2byte*결제수단VA
결제수단
VA: 가상계좌 (고정값)
파라미터
타입
설명
예시
method필수
A(2)
결제수단
VA: 가상계좌 (고정값)
VA
└bizTypeAN(2)영문+숫자, 최대 2byte*업무구분B0
업무구분
B0: 결제 (고정값)
파라미터
타입
설명
예시
bizType필수
AN(2)
업무구분
B0: 결제 (고정값)
B0
└mchtIdAN(10)영문+숫자, 최대 10byte*헥토파이낸셜에서 부여하는 고유 상점아이디nxva_sb_il
헥토파이낸셜에서 부여하는 고유 상점아이디
파라미터
타입
설명
예시
mchtId필수
AN(10)
헥토파이낸셜에서 부여하는 고유 상점아이디
nxva_sb_il
└trdNoAN(40)영문+숫자, 최대 40byte헥토파이낸셜에서 발급한 고유한 거래번호. 회전식/고정식인 경우 필수 응답, 고정무제한은 응답 안함STFP_PGCAnxva_sb_il0211129135810M1494620
헥토파이낸셜에서 발급한 고유한 거래번호. 회전식/고정식인 경우 필수 응답, 고정무제한은 응답 안함
파라미터
타입
설명
예시
trdNo
AN(40)
헥토파이낸셜에서 발급한 고유한 거래번호. 회전식/고정식인 경우 필수 응답, 고정무제한은 응답 안함
STFP_PGCAnxva_sb_il0211129135810M1494620
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유한 상점주문번호ORDER20211231100000
상점에서 생성하는 고유한 상점주문번호
파라미터
타입
설명
예시
mchtTrdNo필수
AN(100)
상점에서 생성하는 고유한 상점주문번호
ORDER20211231100000
└trdDtmN(14)숫자, 최대 14byte*현재 전문을 전송하는 일시 (YYYYMMDDhhmmss)20221105140259
현재 전문을 전송하는 일시 (YYYYMMDDhhmmss)
파라미터
타입
설명
예시
trdDtm필수
N(14)
현재 전문을 전송하는 일시 (YYYYMMDDhhmmss)
20221105140259
└trdAmtN(12)숫자, 최대 12byte*거래금액1000
거래금액
파라미터
타입
설명
예시
trdAmt필수
N(12)
거래금액
1000
└bankCdAN(3)영문+숫자, 최대 3byte*가상계좌 은행코드011
가상계좌 은행코드
파라미터
타입
설명
예시
bankCd필수
AN(3)
가상계좌 은행코드
011
└acntTypeN(1)숫자, 최대 1byte*계좌구분1
계좌구분
1: 기본(회전식) 2: 고정식 3: 고정무제한
파라미터
타입
설명
예시
acntType필수
N(1)
계좌구분
1: 기본(회전식) / 2: 고정식 / 3: 고정무제한
1
└vAcntNoN(64)숫자, 최대 64byte*가상계좌번호 (상점별 암호화 방식)1234567890
가상계좌번호 (상점별 암호화 방식)
파라미터
타입
설명
예시
vAcntNo필수
N(64)
가상계좌번호 (상점별 암호화 방식)
1234567890
└mediaTypeN(2)숫자, 최대 2byte고객이 입금/이체에 사용한 매체의 코드00
고객이 입금/이체에 사용한 매체의 코드
파라미터
타입
설명
예시
mediaType
N(2)
고객이 입금/이체에 사용한 매체의 코드
00
└rcptTypeA(1)영문, 최대 1byte*수취조회 구분 코드N
수취조회 구분 코드
N: 수취조회 P: P 수취조회
*P수취조회 지원 은행 및 2회 전송 동작은 아래 '수취조회 구분 (N / P)' 섹션을 참고하세요.
파라미터
타입
설명
예시
rcptType필수
A(1)
수취조회 구분 코드
N: 수취조회 / P: P 수취조회
* P수취조회 지원 은행 및 2회 전송 동작은 아래 '수취조회 구분 (N / P)' 섹션을 참고하세요.
N
└pktHashAN(64)영문+숫자, 최대 64byte*SHA256 방식으로 생성한 해쉬값6056160d8f24c3ad15a015a0a666b5584c9471c2f8f56945482ca3e656bd0125
SHA256 방식으로 생성한 해쉬값
파라미터
타입
설명
예시
pktHash필수
AN(64)
SHA256 방식으로 생성한 해쉬값
6056160d8f24c3ad15a015a0a666b5584c9471c2f8f56945482ca3e656bd0125

요청 전문 해쉬 코드

항목조합 필드
pktHash결제수단 + 업무구분 + 거래일시 + 상점아이디 + 거래번호 + 거래금액 + 해쉬키
NOTE

해쉬 생성 조합

method + bizType + trdDtm + mchtId + trdNo + trdAmt(평문) + hashKey

매체 코드

코드코드명비고
00기타은행에서 정보 미제공시 "00" 설정
01당행창구
02타행창구
03당행 CD/ATM
04타행 CD/ATM
05텔레뱅킹
06인터넷뱅킹
07스마트뱅킹
08전자금융공동망
09자동이체입금지로, CMS, VAN 자금, 납부자 등
10실시간이체
11무인공과금

수취조회 구분 (N / P)

rcptType은 이번 요청이 일반 수취조회(N)인지 P수취조회(P)인지를 구분합니다.

P수취조회 지원 은행은 수취조회가 2회 전송될 수 있습니다

P수취조회를 지원하는 은행은 하나의 입금 건에 대해 일반 수취조회(N)와 P수취조회(P)가 각각 전송되어, 수취조회 요청이 최대 2회 발생할 수 있습니다. 중복 수신을 원치 않으면 P수취조회(P)만 수신하도록 설정을 신청할 수 있습니다. (영업담당자 문의)

은행별 P수취조회 지원 여부

은행코드은행명P수취조회
003IBK기업은행Y
004KB국민은행Y
011NH농협은행Y
020우리은행Y
023SC제일은행N
031iM뱅크(대구은행)Y
032부산은행N
034광주은행N
039경남은행Y
071우체국Y
081하나은행(KEB하나은행)Y
088신한은행Y
089케이뱅크Y
NOTE

우체국 P수취조회 예외

우체국은 P수취조회를 지원하지만, ATM·창구 등 현금성 매체로 입금하는 경우에는 통지성 전문이 수신되어 P수취조회가 전송되지 않습니다.

응답 파라미터 (가맹점 → 헥토파이낸셜)

가맹점에서 헥토파이낸셜로 응답하는 파라미터입니다.

└rsltCdN(4)숫자, 최대 4byte*결과코드0000
결과코드
0000: 정상 0001: 계좌없음 0002: 입금기한 만료 0003: 금액오류 0004: 허용되지 않은 매체 0009: 기타오류
파라미터
타입
설명
예시
rsltCd필수
N(4)
결과코드
0000: 정상 / 0001: 계좌없음 / 0002: 입금기한 만료 / 0003: 금액오류 / 0004: 허용되지 않은 매체 / 0009: 기타오류
0000
└rsltMsgAHN(200)영문+한글+숫자, 최대 200byte*결과메세지정상적으로 처리되었습니다.
결과메세지
*가맹점 내부 참고용으로 작성하세요.
파라미터
타입
설명
예시
rsltMsg필수
AHN(200)
결과메세지
* 가맹점 내부 참고용으로 작성하세요.
정상적으로 처리되었습니다.

응답 결과코드

결과코드결과메시지설명
0000정상수취조회 성공, 입금 허용
0001계좌없음해당 가상계좌가 존재하지 않음
0002입금기한 만료가상계좌 입금기한이 만료됨
0003금액오류입금금액이 채번금액과 일치하지 않음
0004허용되지 않은 매체해당 매체로의 입금이 허용되지 않음
0009기타오류기타 오류 발생

응답 예시

성공

{
  "rsltCd": "0000",
  "rsltMsg": "정상적으로 처리되었습니다."
}

실패 (입금기한 만료)

{
  "rsltCd": "0002",
  "rsltMsg": "입금기한이 만료되었습니다."
}

실패 (금액오류)

{
  "rsltCd": "0003",
  "rsltMsg": "입금금액이 일치하지 않습니다."
}

가맹점 구현 가이드

NOTE

수취조회 처리 로직

가맹점에서는 수취조회 요청을 받으면 해당 주문의 유효성(계좌 존재, 입금기한, 금액)을 확인하고 결과를 응답해야 합니다.

구현 체크리스트

  1. 계좌 존재 여부 확인: mchtTrdNo 또는 vAcntNo로 주문 조회
  2. 입금기한 확인: 현재 시간이 입금기한 이전인지 확인
  3. 금액 확인: trdAmt가 채번 시 설정한 금액과 일치하는지 확인
  4. 해쉬 검증: pktHash 값 검증으로 데이터 위변조 확인

샘플 코드 (Node.js)

app.post('/api/receipt-inquiry', (req, res) => {
  const { mchtTrdNo, trdAmt, vAcntNo, pktHash } = req.body;

  // 1. 해쉬 검증
  if (!verifyHash(req.body, pktHash)) {
    return res.json({ rsltCd: '0009', rsltMsg: '해쉬 검증 실패' });
  }

  // 2. 주문 조회
  const order = findOrderByTrdNo(mchtTrdNo);
  if (!order) {
    return res.json({ rsltCd: '0001', rsltMsg: '계좌없음' });
  }

  // 3. 입금기한 확인
  if (new Date() > order.expireDate) {
    return res.json({ rsltCd: '0002', rsltMsg: '입금기한 만료' });
  }

  // 4. 금액 확인
  if (order.amount !== parseInt(trdAmt)) {
    return res.json({ rsltCd: '0003', rsltMsg: '금액오류' });
  }

  // 5. 성공 응답
  return res.json({ rsltCd: '0000', rsltMsg: '정상' });
});

요청/응답 예시

수취 조회 요청 (헥토파이낸셜 → 가맹점)

POST /your-receipt-inquiry-url HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=UTF-8

method=VA
&bizType=B0
&mchtId=nxva_sb_il
&trdNo=STFP_PGVAnxva_sb_il0211231100000M1234567
&mchtTrdNo=ORDER20211231100000
&trdDtm=20211231120000
&trdAmt=50000
&bankCd=011
&acntType=1
&vAcntNo=12345678901234
&mediaType=06
&rcptType=N
&pktHash=6056160d8f24c3ad15a015a0a666b5584c9471c2f8f56945482ca3e656bd0125

응답 - 성공 (가맹점 → 헥토파이낸셜)

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{
  "rsltCd": "0000",
  "rsltMsg": "정상"
}

응답 - 실패 (가맹점 → 헥토파이낸셜)

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8

{
  "rsltCd": "0003",
  "rsltMsg": "금액오류"
}
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub