헥토파이낸셜 개발자센터
Products서비스
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
API & SDKAPI & SDK
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그블로그
FAQFAQ
서비스 상태
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그
기술 블로그 및 소식
FAQ
자주 묻는 질문
서비스 상태
서비스 장애 및 점검 현황
시작하기신용카드 결제가상계좌 결제010 가상계좌계좌이체 결제휴대폰 결제상품권 결제포인트 다모아간편결제
내통장결제
펌뱅킹오픈뱅킹
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
시작하기신용카드 결제가상계좌 결제010 가상계좌계좌이체 결제휴대폰 결제상품권 결제포인트 다모아간편결제
내통장결제
펌뱅킹오픈뱅킹
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
서비스현금영수증현금영수증 개요

현금영수증

현금 결제가 발생하면 고객은 소득공제 또는 지출증빙을 위한 현금영수증 발급을 요청합니다.
가맹점이 국세청과 직접 연동하려면 별도의 시스템 구축이 필요하고, 발급 결과 확인이나 오류 재처리까지 직접 관리해야 합니다.

헥토파이낸셜 현금영수증 서비스는 이 과정을 대행합니다.

가맹점은 발급 요청 API를 호출해 거래 정보를 전달하기만 하면 됩니다.
헥토파이낸셜이 익일 국세청으로 일괄 전송하고, 발급 결과를 수신해 조회할 수 있도록 제공합니다.

개발자는 API 응답으로 반환되는 승인번호, 응답코드, 상태값을 저장하고, 익일 조회 API를 통해 현금영수증 발급 완료 여부와 응답코드로 정상 처리 여부를 판단합니다.

NOTE

현금영수증 핵심 흐름. 발급/취소 API 호출 → 승인번호 발급 → D+1 국세청 일괄 전송 → 오류내역 조회/재처리.

서비스 기능 알아보기

주요 특징

현금 결제 시 소득공제 또는 지출증빙을 위한 현금영수증 발급을 대행하는 서비스입니다. 가맹점은 API 호출만으로 국세청 현금영수증 발급·취소·조회를 처리할 수 있습니다.

  • 현금영수증 발급 : 거래 정보를 국세청에 전송하여 소득공제 또는 지출증빙 영수증을 생성합니다.
  • 현금영수증 취소 : 원거래 승인번호를 기반으로 발행된 영수증을 국세청으로 승인 취소 처리합니다.
  • 현금영수증 조회 : 발급 요청건의 처리 상태(성공/오류/진행중)와 승인 상세 내역을 확인합니다.
  • 자진발급 처리 : 구매자 정보 부재나 특정 에러 시, 국세청 지정번호(010-000-1234)로 영수증을 우선 발급합니다. (사용자 정보 미수집 시 법적 의무 이행)
  • 가상계좌 연동발급 : 입금 완료 시점에 맞춰 현금영수증이 자동 발행할 수 있습니다.
발급/취소결제창 ✗API ✓

현금영수증 발급 및 취소를 처리합니다. 발급 시 소득공제/지출증빙 용도를 구분하여 요청하고, 취소 시 원거래 승인번호를 기반으로 처리합니다.

  • 발급 요청 시 용도(purpose)를 소득공제(0) 또는 지출증빙(1)으로 구분합니다.
  • 취소 시 원거래번호(orgTrdNo)를 매칭하여 처리합니다.
  • API 응답으로 승인번호, 발급일자가 반환됩니다.
조회/재처리결제창 ✗API ✓

발급 요청건의 처리 상태를 확인하고, 오류 건에 대해 재처리를 요청합니다. 오류내역은 D+1 13시 이후부터 조회 가능합니다.

  • 처리 상태(statCd)로 정상/취소/오류 여부를 확인할 수 있습니다.
  • 오류 건은 재처리 등록 API로 재발급을 요청할 수 있습니다.
  • 재처리 시 신규 승인번호가 발급되며, D+2에 국세청으로 전송됩니다.
NOTE
자진발급된 현금영수증은 고객이 국세청 홈택스에서 본인 명의로 변경할 수 있습니다.

서비스 흐름 알아보기

  • 현금영수증은 모든 기능이 API 방식으로 제공됩니다.
  • 발급 요청 후 국세청 전송은 익일(D+1) 일괄 처리 방식입니다.

발급/취소 흐름

가맹점이 현금영수증 발급 또는 취소를 요청하면, 헥토파이낸셜이 익일 국세청으로 일괄 전송합니다. 오류내역은 D+1 13시 이후부터 조회할 수 있습니다.

가맹점
헥토파이낸셜
국세청
11. 현금영수증 등록/취소 요청
1. 현금영수증 등록/취소 요청
22. 승인번호, 발급일자 응답
2. 승인번호, 발급일자 응답
33. D+1 00시, 국세청 일괄 전송
3. D+1 00시, 국세청 일괄 전송
44. D+1 9~12시, 오류내역 수신
4. D+1 9~12시, 오류내역 수신
55. 13시 이후, 오류내역 조회
5. 13시 이후, 오류내역 조회

각 단계 상세

  1. 1등록/취소 요청 : 가맹점이 현금영수증 발급 또는 취소 API를 호출합니다.
  2. 2승인번호 응답 : 헥토파이낸셜이 승인번호와 발급일자를 응답합니다.
  3. 3국세청 일괄 전송 : 요청 익일(D+1) 00시에 헥토파이낸셜이 국세청으로 일괄 전송합니다.
  4. 4오류내역 수신 : D+1 9~12시에 국세청에서 오류내역을 수신합니다.
  5. 5오류내역 조회 : 가맹점이 D+1 13시 이후 오류내역 조회 API로 결과를 확인합니다.
현금영수증은 실시간 발급이 아닙니다. 요청 시점에 승인번호가 발급되지만, 국세청 전송은 익일(D+1) 00시에 일괄 처리됩니다. 오류 여부는 D+1 13시 이후 조회 API로 확인해 주세요.

재처리 흐름

국세청 전송 시 오류가 발생한 건에 대해 재처리를 요청하는 과정입니다. 재처리 시 신규 승인번호가 발급되며, D+2에 국세청으로 재전송됩니다.

가맹점
헥토파이낸셜
국세청
11. 재처리 등록 요청
1. 재처리 등록 요청
22. 신규 승인번호 응답
2. 신규 승인번호 응답
33. D+2 국세청 일괄 전송
3. D+2 국세청 일괄 전송
44. 재처리 결과 수신
4. 재처리 결과 수신
55. 재처리 결과내역 조회
5. 재처리 결과내역 조회

각 단계 상세

  1. 1재처리 등록 요청 : 가맹점이 오류 건에 대해 재처리 등록 API를 호출합니다.
  2. 2신규 승인번호 응답 : 헥토파이낸셜이 신규 승인번호를 발급하여 응답합니다.
  3. 3국세청 재전송 : D+2에 헥토파이낸셜이 국세청으로 재전송합니다.
  4. 4재처리 결과 수신 : 국세청에서 재처리 결과를 수신합니다.
  5. 5결과내역 조회 : 가맹점이 재처리 결과내역 조회 API로 결과를 확인합니다.
NOTE
자동재처리 가맹점 등록이 가능합니다. 영업담당자를 통해 자동재처리 가맹점으로 등록하면, 오류코드에 따라 헥토파이낸셜에서 자동으로 재처리됩니다. 자동재처리 시 자진발급번호로 발급됩니다.

연동 전 확인사항

연동을 시작하기 전에, 아래 사항을 미리 확인해 두시면 좋습니다.

국세청 전송 일정

  • 현금영수증은 요청 익일(D+1) 00시에 국세청으로 일괄 전송됩니다.
  • 오류내역은 D+1 13시 이후부터 조회 가능합니다.

자동재처리 가맹점

  • 영업담당자를 통해 자동재처리 가맹점으로 등록할 수 있습니다.
  • 오류코드에 따라 헥토파이낸셜에서 자동으로 재처리되며, 자진발급번호로 발급됩니다.
NOTE

체육시설 문화비 공제 (2025년 7월 시행)

2025년 7월 1일 이후 체육시설 사용료(수영장, 헬스 등)도 문화비로 추가공제됩니다. 강습료는 50% 공제, 입장료/대여료는 100% 공제됩니다.

현금영수증 개발 문서 바로가기

📝

등록/취소 API

현금영수증 발급 및 취소

🔍

조회 API

발급상태 및 오류내역 조회

🔄

재처리 API

오류 건 재처리

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub