현금영수증
현금 결제가 발생하면 고객은 소득공제 또는 지출증빙을 위한 현금영수증 발급을 요청합니다.
가맹점이 국세청과 직접 연동하려면 별도의 시스템 구축이 필요하고, 발급 결과 확인이나 오류 재처리까지 직접 관리해야 합니다.
헥토파이낸셜 현금영수증 서비스는 이 과정을 대행합니다.
가맹점은 발급 요청 API를 호출해 거래 정보를 전달하기만 하면 됩니다.
헥토파이낸셜이 익일 국세청으로 일괄 전송하고, 발급 결과를 수신해 조회할 수 있도록 제공합니다.
개발자는 API 응답으로 반환되는 승인번호, 응답코드, 상태값을 저장하고, 익일 조회 API를 통해 현금영수증 발급 완료 여부와 응답코드로 정상 처리 여부를 판단합니다.
현금영수증 핵심 흐름. 발급/취소 API 호출 → 승인번호 발급 → D+1 국세청 일괄 전송 → 오류내역 조회/재처리.
서비스 기능 알아보기
현금 결제 시 소득공제 또는 지출증빙을 위한 현금영수증 발급을 대행하는 서비스입니다. 가맹점은 API 호출만으로 국세청 현금영수증 발급·취소·조회를 처리할 수 있습니다.
- 현금영수증 발급 : 거래 정보를 국세청에 전송하여 소득공제 또는 지출증빙 영수증을 생성합니다.
- 현금영수증 취소 : 원거래 승인번호를 기반으로 발행된 영수증을 국세청으로 승인 취소 처리합니다.
- 현금영수증 조회 : 발급 요청건의 처리 상태(성공/오류/진행중)와 승인 상세 내역을 확인합니다.
- 자진발급 처리 : 구매자 정보 부재나 특정 에러 시, 국세청 지정번호(010-000-1234)로 영수증을 우선 발급합니다. (사용자 정보 미수집 시 법적 의무 이행)
- 가상계좌 연동발급 : 입금 완료 시점에 맞춰 현금영수증이 자동 발행할 수 있습니다.
현금영수증 발급 및 취소를 처리합니다. 발급 시 소득공제/지출증빙 용도를 구분하여 요청하고, 취소 시 원거래 승인번호를 기반으로 처리합니다.
- 발급 요청 시 용도(purpose)를 소득공제(0) 또는 지출증빙(1)으로 구분합니다.
- 취소 시 원거래번호(orgTrdNo)를 매칭하여 처리합니다.
- API 응답으로 승인번호, 발급일자가 반환됩니다.
발급 요청건의 처리 상태를 확인하고, 오류 건에 대해 재처리를 요청합니다. 오류내역은 D+1 13시 이후부터 조회 가능합니다.
- 처리 상태(statCd)로 정상/취소/오류 여부를 확인할 수 있습니다.
- 오류 건은 재처리 등록 API로 재발급을 요청할 수 있습니다.
- 재처리 시 신규 승인번호가 발급되며, D+2에 국세청으로 전송됩니다.
서비스 흐름 알아보기
- 현금영수증은 모든 기능이 API 방식으로 제공됩니다.
- 발급 요청 후 국세청 전송은 익일(D+1) 일괄 처리 방식입니다.
발급/취소 흐름
가맹점이 현금영수증 발급 또는 취소를 요청하면, 헥토파이낸셜이 익일 국세청으로 일괄 전송합니다. 오류내역은 D+1 13시 이후부터 조회할 수 있습니다.
각 단계 상세
- 1등록/취소 요청 : 가맹점이 현금영수증 발급 또는 취소 API를 호출합니다.
- 2승인번호 응답 : 헥토파이낸셜이 승인번호와 발급일자를 응답합니다.
- 3국세청 일괄 전송 : 요청 익일(D+1) 00시에 헥토파이낸셜이 국세청으로 일괄 전송합니다.
- 4오류내역 수신 : D+1 9~12시에 국세청에서 오류내역을 수신합니다.
- 5오류내역 조회 : 가맹점이 D+1 13시 이후 오류내역 조회 API로 결과를 확인합니다.
재처리 흐름
국세청 전송 시 오류가 발생한 건에 대해 재처리를 요청하는 과정입니다. 재처리 시 신규 승인번호가 발급되며, D+2에 국세청으로 재전송됩니다.
각 단계 상세
- 1재처리 등록 요청 : 가맹점이 오류 건에 대해 재처리 등록 API를 호출합니다.
- 2신규 승인번호 응답 : 헥토파이낸셜이 신규 승인번호를 발급하여 응답합니다.
- 3국세청 재전송 : D+2에 헥토파이낸셜이 국세청으로 재전송합니다.
- 4재처리 결과 수신 : 국세청에서 재처리 결과를 수신합니다.
- 5결과내역 조회 : 가맹점이 재처리 결과내역 조회 API로 결과를 확인합니다.
연동 전 확인사항
연동을 시작하기 전에, 아래 사항을 미리 확인해 두시면 좋습니다.
국세청 전송 일정
- 현금영수증은 요청 익일(D+1) 00시에 국세청으로 일괄 전송됩니다.
- 오류내역은 D+1 13시 이후부터 조회 가능합니다.
자동재처리 가맹점
- 영업담당자를 통해 자동재처리 가맹점으로 등록할 수 있습니다.
- 오류코드에 따라 헥토파이낸셜에서 자동으로 재처리되며, 자진발급번호로 발급됩니다.
