헥토파이낸셜 개발자센터
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가 다릅니다.


취소 유형

유형설명지원 결제수단
전체취소결제 금액 전액 취소모든 결제수단
부분취소일부 금액만 취소신용카드, 휴대폰, 간편결제, 티머니, 일부 상품권
채번취소입금 전 가상계좌 취소가상계좌
환불입금 완료 후 고객 계좌로 환불가상계좌, 계좌이체, 현금영수증

취소 기한 요약

결제수단취소 기한부분취소비고
신용카드1년O당일: 승인취소, 익일 이후: 매입취소
가상계좌1년O입금 전: 채번취소, 입금 후: 환불 API
계좌이체180일X당일: 취소, 익일 이후: 환불
휴대폰당월O익월 이후: 환불 API
티머니90일O-
상품권1년△틴캐쉬만 부분취소 가능
포인트다모아1년X전체취소 후 재승인 방식
간편결제1년O신용카드 정책과 동일
현금영수증당해 연도X당일: 취소, 익일 이후: 환불

부분취소 가능 여부

부분취소는 가맹점별 설정에 따라 다릅니다. 부분취소가 필요한 경우 영업 담당자에게 설정을 요청하세요.

결제수단별 취소 방식

신용카드

  • 취소 기한: 결제일로부터 1년 이내
  • 당일 취소: 승인 취소 (즉시 취소)
  • 익일 이후 취소: 매입 취소
  • 부분취소: 지원 (취소회차 순차 증가 필요)
가맹점
헥토파이낸셜
카드사
1취소 API 요청
취소 API 요청
2취소 요청 전달
취소 요청 전달
3취소 결과
취소 결과
4즉시 결과 반환
즉시 결과 반환
NOTE

부분취소 시 주의사항

부분취소 시 cnclOrd(취소회차)를 001부터 순차적으로 증가시켜야 합니다. 예: 1차 부분취소(cnclOrd=001), 2차 부분취소(cnclOrd=002)

가상계좌

가상계좌는 상태에 따라 취소/환불 방식이 다릅니다.

상태처리 방식API
입금 전채번취소채번취소 API
입금 후환불 (고객 계좌로 송금)환불 API
가맹점
헥토파이낸셜
고객
1입금 전: 채번취소 API
입금 전: 채번취소 API
2채번취소 완료
채번취소 완료
가맹점
헥토파이낸셜
고객 계좌
1입금 후: 환불 API
입금 후: 환불 API
2환불 등록 완료
환불 등록 완료
3익영업일: 환불금 송금
익영업일: 환불금 송금

가상계좌 환불 주의사항

입금 완료된 가상계좌는 채번취소가 불가능합니다. 반드시 환불 API를 사용하여 고객의 실제 계좌로 환불해야 합니다.

계좌이체

  • 취소 기한: 180일 이내
  • 당일 취소: 전체취소만 가능 (출금 계좌로 실시간 입금)
  • 익일 이후: 환불 API 사용 (부분환불 가능)
  • 환불 계좌: 결제 시 사용한 계좌 또는 별도 지정 계좌
NOTE

계좌이체 취소 특이사항

당일 거래는 전체취소만 가능하며, 부분취소가 필요한 경우 익일 이후 환불 API를 사용하세요.

휴대폰결제

  • 취소 방식: 취소 API 호출
  • 부분취소: 지원
  • 취소 기한: 결제 당월 말일까지 (익월부터 환불 API 사용)

휴대폰결제 익월 취소 불가

휴대폰결제는 결제월 말일이 지나면 API로 취소할 수 없습니다. 익월 환불은 통신사와 별도 협의가 필요합니다.

상품권

  • 취소 기한: 1년 이내
  • 취소 방식: 취소 API 호출
  • 부분취소: 상품권 종류에 따라 상이
상품권 종류부분취소
틴캐쉬O
컬처캐쉬X
도서상품권X
스마트문상X
NOTE

부분취소 미지원 상품권

컬처캐쉬, 도서상품권, 스마트문상은 부분취소가 불가능합니다. 전체취소 후 재승인 방식으로 처리하세요.

포인트다모아

  • 취소 기한: 1년 이내
  • 취소 방식: 취소 API 호출
  • 부분취소: 미지원 (전체취소 후 재승인 방식)

티머니

  • 취소 기한: 90일 이내
  • 취소 방식: 취소 API 호출
  • 부분취소: 지원 (취소회차 순차 증가 필요)

간편결제 (카카오페이, 네이버페이, 토스페이, 페이코)

  • 취소 기한: 1년 이내
  • 당일 취소: 즉시 취소
  • 익일 이후 취소: 매입 취소 (3~5일 소요)
  • 부분취소: 지원 (취소회차 순차 증가 필요)
NOTE

간편결제 취소 정책

간편결제는 내부적으로 신용카드로 처리되므로, 신용카드 취소 정책과 동일합니다. 단, 기프트(선불)카드로 결제한 경우 부분취소가 불가능합니다.

현금영수증

  • 취소 기한: 당해 연도 이내
  • 당일 취소: 즉시 취소
  • 익일 이후: 환불 처리
  • 부분취소: 미지원

현금영수증 취소 기한

현금영수증은 발행 연도 내에만 취소가 가능합니다. 연도가 바뀌면 취소할 수 없으므로 주의하세요.

부분취소 불가 조건

다음 조건에 해당하는 경우 부분취소가 불가능합니다.

조건해당 결제수단대안
최소금액 미만모든 결제수단전체취소 후 재승인
기프트(선불)카드 결제간편결제전체취소 후 재승인
컬처캐쉬/도서상품권/스마트문상상품권전체취소 후 재승인
당일 거래계좌이체익일 이후 환불 API
가맹점 설정 미적용모든 결제수단영업 담당자에게 설정 요청

결제수단별 최소금액

결제수단최소 취소금액최대 취소금액
신용카드100원영업담당자 협의
간편결제 (신용카드)100원영업담당자 협의
간편결제 (머니/포인트)0원 초과영업담당자 협의
현금영수증0원 초과영업담당자 협의
가상계좌0원 초과-
NOTE

최소금액 주의

부분취소 후 남은 금액이 최소금액 미만이 되는 경우 부분취소가 거부될 수 있습니다.

1년 경과 건 취소

신용카드 및 간편결제의 취소 기한은 1년이지만, 가맹점에서 직접 취소할 수 있는 기간은 1년 이내입니다.

경과 기간취소 방법
1년 이내가맹점에서 API 또는 관리자페이지로 직접 취소
1년 초과헥토파이낸셜 담당자에게 요청

1년 초과 거래 취소

1년이 경과한 거래는 가맹점에서 직접 취소할 수 없습니다. 취소가 필요한 경우 헥토파이낸셜 담당자에게 요청하세요.

취소한도 초과 처리

정산금액이 부족하여 취소가 불가능한 경우, 역환금 입금 후 자동취소 처리가 가능합니다.

신용카드 역환취소 절차

  1. 가맹점 관리자에서 취소 요청
  2. 정산금액 부족 시 가상계좌 발급 안내
  3. 발급된 가상계좌로 역환금액 입금
  4. 입금 확인 후 자동 취소 처리
NOTE

역환취소 처리 시간

역환금 입금 확인 후 약 5분 이내에 취소가 자동 처리됩니다.

취소 완료 시점

취소 API 응답 ≠ 실제 취소 완료

취소 API의 성공 응답은 취소 요청 접수를 의미합니다. 실제 취소 처리 완료까지 시간이 소요될 수 있습니다.
결제수단취소 유형실제 반영 시점
신용카드당일 승인취소즉시
신용카드부분취소/매입취소3~5일
가상계좌환불3~5일 (익영업일 입금)
계좌이체당일 취소즉시 (출금계좌로 입금)
간편결제매입취소3~5일

취소 응답 코드

outStatCdoutRsltCd설명
00210000취소 성공
00310001시스템 오류
00310002원거래 없음
00310003취소 가능 금액 초과
00310004이미 취소된 거래

결제수단별 취소 API

결제수단별 취소/환불 API

💳

신용카드 취소

전체취소/부분취소 API

🏧

가상계좌 채번취소

입금 전 채번취소

🏧

가상계좌 환불

입금 후 고객 계좌로 환불

🏦

계좌이체 취소

계좌이체 결제 취소/환불

📱

휴대폰결제 취소

휴대폰 소액결제 취소

🎁

상품권 취소

상품권 결제 취소

🚇

티머니 취소

티머니 결제 취소

💰

간편결제 취소

카카오페이/네이버페이/토스페이/페이코

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub