헥토파이낸셜 개발자센터
ProductsProducts
Payment Gateway
Cards, bank & digital wallets
My Bank Pay
Open banking debit
Easy Cash Payment
Stored-account payments
White-Label Payments
White-label checkout
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Integrate with LLMs
MCP server & AI chatbot
API & SDKAPI & SDK
Payment Gateway
Cards, bank & digital wallets
My Bank Pay
Open banking debit
Easy Cash Payment
Stored-account payments
White-Label Payments
White-label checkout
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
블로그Blog
Service Status
Payment Gateway
My Bank Pay
Easy Cash Payment
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Integrate with LLMs
MCP 서버 및 AI 챗봇
Payment Gateway
My Bank Pay
Easy Cash Payment
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Blog
Technical blog & news
Service Status
Incidents and scheduled maintenance
Getting StartedCredit CardVirtual Account010 Virtual AccountBank TransferMobile PaymentGift CardPoint DamoaDigital Wallets
My Bank Pay
Firm BankingOpen Banking
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
Getting StartedCredit CardVirtual Account010 Virtual AccountBank TransferMobile PaymentGift CardPoint DamoaDigital Wallets
My Bank Pay
Firm BankingOpen Banking
White-Label Payments
Cash Receipt
Firm Banking
VAN Virtual Account
Prepaid Wallet
ProductsCash ReceiptCash Receipt Overview

Cash Receipt

When a cash payment occurs, customers request cash receipt issuance for income deduction or business expense proof.
For merchants to integrate directly with the NTS, a separate system must be built, and they must also manage issuance result confirmation and error reprocessing themselves.

Hecto Financial's cash receipt service handles this entire process.

Merchants simply need to call the issuance request API and pass the transaction information.
Hecto Financial transmits the data to the NTS in bulk the following day and provides the issuance results for inquiry.

Developers should store the approval number, response code, and status value returned in the API response, and use the next-day inquiry API to determine whether cash receipt issuance was completed and whether processing was successful based on the response code.

NOTE

Cash receipt core flow. Call issuance/cancellation API → Approval number issued → D+1 bulk transmission to NTS → Error details inquiry/reprocessing.

Service Features

Key Features

A service that handles cash receipt issuance on behalf of merchants for income deduction or business expense proof upon cash payment. Merchants can process NTS cash receipt issuance, cancellation, and inquiry through simple API calls.

  • Cash Receipt Issuance: Transmits transaction information to the NTS to generate an income deduction or business expense proof receipt.
  • Cash Receipt Cancellation: Cancels an issued receipt at the NTS based on the original transaction approval number.
  • Cash Receipt Inquiry: Checks the processing status (success/error/in-progress) and approval details of issuance requests.
  • Self-Issuance: When buyer information is unavailable or a specific error occurs, a receipt is issued first using the NTS-designated number (010-000-1234). (Fulfills legal obligations when user information is not collected)
  • Virtual Account Linked Issuance: A cash receipt can be automatically issued when a deposit to a virtual account is confirmed.
Issuance/CancellationCheckout ✗API ✓

Handles cash receipt issuance and cancellation. For issuance, specify the purpose as income deduction or business expense proof. For cancellation, processing is based on the original transaction approval number.

  • For issuance requests, specify the purpose (purpose) as income deduction (0) or business expense proof (1).
  • For cancellation, match using the original transaction number (orgTrdNo).
  • The API response returns the approval number and issuance date.
Inquiry/ReprocessingCheckout ✗API ✓

Checks the processing status of issuance requests and submits reprocessing requests for error cases. Error details are available for inquiry from D+1 13:00 onward.

  • The processing status (statCd) can be used to check whether the transaction is normal, cancelled, or in error.
  • Error cases can be resubmitted for issuance via the reprocessing registration API.
  • A new approval number is issued upon reprocessing, and it is transmitted to the NTS on D+2.
NOTE
Self-issued cash receipts can be changed to the customer's own name via the NTS Hometax portal.

Service Flow

  • Cash receipts are provided entirely via API.
  • NTS transmission after an issuance request is processed as a next-day (D+1) bulk operation.

Issuance/Cancellation Flow

When a merchant requests cash receipt issuance or cancellation, Hecto Financial transmits the data to the NTS in bulk the following day. Error details can be queried from D+1 13:00 onward.

Merchant
Hecto Financial
NTS
11. Cash receipt registration/cancellation request
1. Cash receipt registration/cancellation request
22. Approval number and issuance date response
2. Approval number and issuance date response
33. D+1 00
3. D+1 00
44. D+1 9
4. D+1 9
55. After 13
5. After 13

Step Details

  1. 1Registration/Cancellation Request : The merchant calls the cash receipt issuance or cancellation API.
  2. 2Approval Number Response : Hecto Financial responds with the approval number and issuance date.
  3. 3Bulk Transmission to NTS : Hecto Financial transmits the data to the NTS in bulk at 00:00 on the day after the request (D+1).
  4. 4Error Details Received : Error details are received from the NTS between D+1 9:00~12:00.
  5. 5Error Details Inquiry : The merchant checks the results via the error details inquiry API from D+1 13:00 onward.
Cash receipts are not issued in real time. An approval number is issued at the time of the request, but NTS transmission is processed in bulk at 00:00 the following day (D+1). Please check for errors via the inquiry API from D+1 13:00 onward.

Reprocessing Flow

The process of requesting reprocessing for cases where an error occurred during NTS transmission. Upon reprocessing, a new approval number is issued and retransmitted to the NTS on D+2.

Merchant
Hecto Financial
NTS
11. Reprocessing registration request
1. Reprocessing registration request
22. New approval number response
2. New approval number response
33. D+2 bulk retransmission to NTS
3. D+2 bulk retransmission to NTS
44. Reprocessing result received
4. Reprocessing result received
55. Reprocessing result inquiry
5. Reprocessing result inquiry

Step Details

  1. 1Reprocessing Registration Request : The merchant calls the reprocessing registration API for error cases.
  2. 2New Approval Number Response : Hecto Financial issues a new approval number and responds.
  3. 3NTS Retransmission : Hecto Financial retransmits to the NTS on D+2.
  4. 4Reprocessing Result Received : The reprocessing result is received from the NTS.
  5. 5Result Inquiry : The merchant checks the results via the reprocessing result inquiry API.
NOTE
Automatic reprocessing merchant registration is available. If registered as an automatic reprocessing merchant through the sales representative, Hecto Financial will automatically reprocess based on the error code. Automatic reprocessing is issued under the self-issuance number.

Pre-Integration Checklist

Before starting integration, please review the following items in advance.

NTS Transmission Schedule

  • Cash receipts are transmitted to the NTS in bulk at 00:00 the day after the request (D+1).
  • Error details are available for inquiry from D+1 13:00 onward.

Automatic Reprocessing Merchant

  • You can register as an automatic reprocessing merchant through the sales representative.
  • Hecto Financial will automatically reprocess based on the error code, and issuance will be made under the self-issuance number.
NOTE

Sports Facility Cultural Expense Deduction (Effective July 2025)

From July 1, 2025, sports facility fees (swimming pools, gyms, etc.) are also eligible for additional cultural expense deductions. Lesson fees qualify for a 50% deduction, while admission fees/rental fees qualify for a 100% deduction.

Cash Receipt Developer Documentation

📝

Registration/Cancellation API

Cash receipt issuance and cancellation

🔍

Inquiry API

Issuance status and error details inquiry

🔄

Reprocessing API

Reprocessing for error cases

💬

Need technical support?

Code Samples

HectoFinancial GitHub