Cash Receipt Reprocessing Registration API
API for registering reprocessing for NTS issuance error records.
Important Notes
Auto-Reprocessing Merchants
- Merchants can enroll in auto-reprocessing through their account manager.
- Hecto Financial automatically reprocesses records based on the NTS error code.
- Auto-reprocessed records are issued using the self-issuance number.
- Void reprocessing is issued using the original approval transaction's registration number.
Non-Auto-Reprocessing Merchants
- When error records are received, the merchant must manually call the reprocessing API.
- Reprocessing requests submitted via the API will receive a newly assigned approval number and issuance date.
Use the Original Transaction Values from the Issuance Error List
Enter the issuance date and approval number of the error transaction to be reprocessed in reTrDt and reAuthNo. Before requesting, cross-check the transaction datetime and approval number from the issuance error list inquiry results against the original transaction data retained by the merchant.
NOTE
Approval Number Assignment Rule
For auto-reprocessing records, if the issuance date is within the NTS registration deadline (3 business days prior), reprocessing uses the originally issued approval number and issuance date; if the deadline has passed, a new approval number is assigned.
In contrast, a transaction reprocessed directly via this API always receives a newly assigned approval number and issuance date, regardless of the business-day criterion.
Void Reprocessing Notes
For void reprocessing, sending identityGb and identity as empty values will process the void using the original transaction data. For partial voids, also send empty values and pass only the calculated void amount.
API Information
GET/POST/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo
Content-Type
요청
application/x-www-form-urlencoded;charset=UTF-8응답
text/plain;charset=UTF-8테스트
https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo운영
https://cash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfoRegistration Reprocessing Request Parameters
Add the reprocessing-related fields to the base registration API parameters.
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└midAN(10)Alphanumeric, up to 10 bytes*Merchant ID.
Merchant ID.
*Merchant ID issued by Hecto Financial
└assortA(1)Alphabetic, up to 1 bytes*Approval type.
Approval type.
0: Approval (Registration)└transNoAN(50)Alphanumeric, up to 50 bytes*Order number (unique merchant identifier).
Order number (unique merchant identifier).
*Duplicate order numbers are rejected regardless of date.
└ordNmAN(40)Alphanumeric, up to 40 bytesOrderer name.
Orderer name.
└trDtAN(14)Alphanumeric, up to 14 bytes*Transaction datetime (yyyyMMddHHmmss).
Transaction datetime (yyyyMMddHHmmss).
└taxYnA(1)Alphabetic, up to 1 bytesTax type.
Tax type.
N: Taxable Y: Tax-exempt G: Mixed taxation*N (taxable): enter the taxable amount in amt and the VAT in vat
Y (tax-exempt): enter the tax-free amount in amt and 0 in vat
G (mixed taxation): enter the taxable + tax-free amount in amt and the VAT on the taxable portion in vat (0 VAT is also valid)
Not entered (null): enter the total transaction amount in amt; it is auto-calculated based on the registered merchant account settings
Y (tax-exempt): enter the tax-free amount in amt and 0 in vat
G (mixed taxation): enter the taxable + tax-free amount in amt and the VAT on the taxable portion in vat (0 VAT is also valid)
Not entered (null): enter the total transaction amount in amt; it is auto-calculated based on the registered merchant account settings
└amtN(10)Numeric, up to 10 bytes*Supply value.
Supply value.
*Taxable: taxable amount; Tax-exempt: tax-free amount; Mixed taxation: taxable + tax-free amount
└vatN(10)Numeric, up to 10 bytes*VAT.
VAT.
*Taxable: VAT; Tax-exempt: 0; Mixed taxation: VAT on the taxable portion
└svcAmtN(10)Numeric, up to 10 bytes*Service charge.
Service charge.
└bizRegNoN(10)Numeric, up to 10 bytesSub-business registration number.
Sub-business registration number.
└purposeA(1)Alphabetic, up to 1 bytes*Purpose type.
Purpose type.
0: Income deduction 1: Expense proof*Enter 0 (income deduction) when requesting with the self-issuance number
└identityGbA(1)Alphabetic, up to 1 bytes*Cash receipt registration number type.
Cash receipt registration number type.
1: Card number (NTS-registered card) 2: Resident registration number 3: Business registration number 4: Mobile phone number*Enter 4 (mobile phone number) when requesting with the self-issuance number
└identityN(18)Numeric, up to 18 bytes*Cash receipt registration number.
Cash receipt registration number.
*Enter the registration number matching the identityGb type
Enter digits only
Self-issuance number: 0100001234 (10 digits, not the 11-digit number 010-0000-1234)
Enter digits only
Self-issuance number: 0100001234 (10 digits, not the 11-digit number 010-0000-1234)
└deductionTypeA(1)Alphabetic, up to 1 bytesAdditional deduction type.
Additional deduction type.
Y: Public transportation C: Cultural expenses (books, performances, sports facilities) T: Traditional market B: Books/performances at traditional market*Enter only for the applicable additional-deduction transaction
A single business that provides cultural expense income deduction is processed as cultural expenses even if the value is omitted
If the business registration number designated for traditional market / cultural expenses at a traditional market is not registered with the NTS, it is processed as standard income deduction
From 2025/07/01, sports facility fees (swimming pools, gyms, etc.) are also included in cultural expenses (C): training fees 50%, entry fees and equipment rental (towels, sportswear) 100% deduction
A single business that provides cultural expense income deduction is processed as cultural expenses even if the value is omitted
If the business registration number designated for traditional market / cultural expenses at a traditional market is not registered with the NTS, it is processed as standard income deduction
From 2025/07/01, sports facility fees (swimming pools, gyms, etc.) are also included in cultural expenses (C): training fees 50%, entry fees and equipment rental (towels, sportswear) 100% deduction
└reYnA(1)Alphabetic, up to 1 bytes*Reprocessing flag.
Reprocessing flag.
Y: Reprocessing request*Fixed to Y for a reprocessing request
└reTrDtN(8)Numeric, up to 8 bytes*Original transaction issuance date for reprocessing (yyyyMMdd).
Original transaction issuance date for reprocessing (yyyyMMdd).
*Enter the issuance date of the error transaction to be reprocessed
└reAuthNoAN(9)Alphanumeric, up to 9 bytes*Original transaction approval number for reprocessing.
Original transaction approval number for reprocessing.
*Enter the approval number of the error transaction to be reprocessed
Void Reprocessing Request Parameters
For void reprocessing, send the same base parameters as registration reprocessing along with the following additional parameters.
└assortA(1)Alphabetic, up to 1 bytes*Approval type.
Approval type.
1: Void└authNoAN(9)Alphanumeric, up to 9 bytes*Original transaction approval number.
Original transaction approval number.
└orgTrDtAN(14)Alphanumeric, up to 14 bytes*Original transaction approval datetime (yyyyMMddHHmmss).
Original transaction approval datetime (yyyyMMddHHmmss).
└reYnA(1)Alphabetic, up to 1 bytes*Reprocessing flag.
Reprocessing flag.
Y: Reprocessing request└reTrDtN(8)Numeric, up to 8 bytes*Original transaction issuance date for reprocessing (yyyyMMdd).
Original transaction issuance date for reprocessing (yyyyMMdd).
*Enter the issuance date of the error transaction to be reprocessed
└reAuthNoAN(9)Alphanumeric, up to 9 bytes*Original transaction approval number for reprocessing.
Original transaction approval number for reprocessing.
*Enter the approval number of the error transaction to be reprocessed
Response Parameters
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└resultCdAN(4)Alphanumeric, up to 4 bytes*Response code.
0000Response code.
0000: Success└resultMsgAHN(100)Alphanumeric + Korean, up to 100 bytes*Response message.
Cash receipt registration was successful.Response message.
└trTimeN(14)Numeric, up to 14 bytes*Issuance datetime.
20180401001200Issuance datetime.
*For registration reprocessing, the trDt value is returned; for void reprocessing, the API request datetime is returned. The merchant must manage this value.
└authNoAN(9)Alphanumeric, up to 9 bytes*Approval number (newly assigned).
F62624676Approval number (newly assigned).
*Merchant must retain this value.
Registration Reprocessing Request Example
https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo
&mid=mid_test
&assort=0
&transNo=test115
&ordNm=Test
&trDt=20180401001200
&taxYn=N
&amt=10000
&vat=1000
&svcAmt=0
&bizRegNo=0001112222
&purpose=0
&identityGb=4
&identity=0100001234
&deductionType=
&reYn=Y
&reTrDt=20180401
&reAuthNo=F62624672
Void Reprocessing Request Example
https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo
&mid=mid_test
&assort=1
&transNo=CA20210316144124
&trDt=20210316144124
&taxYn=N
&amt=9090
&vat=910
&svcAmt=0
&purpose=0
&identityGb=
&identity=
&deductionType=
&authNo=F67198300
&orgTrDt=20210316144106
&reYn=Y
&reTrDt=20210316
&reAuthNo=F62624672
Response Example
Success
{
"trTime": "20180401001200",
"resultCd": "0000",
"authNo": "F62624676",
"resultMsg": "Cash receipt registration was successful."
}
Failure
{
"trTime": "",
"resultCd": "1118",
"authNo": "",
"resultMsg": "Original transaction information for reprocessing does not exist."
}
Reprocessing-Related Error Codes
| Code | Message | Description |
|---|---|---|
| 1118 | Original transaction information for reprocessing does not exist. | No original transaction |
| 1119 | This record is subject to auto-reprocessing. | Auto-reprocessing target |
| 1120 | A reprocessing request already exists. | Duplicate reprocessing request |
| 1121 | Please check the parameters. | Parameter error |
Need technical support?
Code Samples
HectoFinancial GitHub