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.
Cash receipt core flow. Call issuance/cancellation API → Approval number issued → D+1 bulk transmission to NTS → Error details inquiry/reprocessing.
Service 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.
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.
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.
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.
Step Details
- 1Registration/Cancellation Request : The merchant calls the cash receipt issuance or cancellation API.
- 2Approval Number Response : Hecto Financial responds with the approval number and issuance date.
- 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).
- 4Error Details Received : Error details are received from the NTS between D+1 9:00~12:00.
- 5Error Details Inquiry : The merchant checks the results via the error details 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.
Step Details
- 1Reprocessing Registration Request : The merchant calls the reprocessing registration API for error cases.
- 2New Approval Number Response : Hecto Financial issues a new approval number and responds.
- 3NTS Retransmission : Hecto Financial retransmits to the NTS on D+2.
- 4Reprocessing Result Received : The reprocessing result is received from the NTS.
- 5Result Inquiry : The merchant checks the results via the reprocessing result inquiry API.
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.
