Cash Receipt Void API
API for voiding a cash receipt registered with the NTS.
Important Notes
- The void order number (transNo) must be a new number different from the original order number.
- Partial voids can be requested multiple times, but the cumulative void amount cannot exceed the original transaction amount. (e.g., voiding an original 1,000 KRW registration twice by 1,000 KRW each on the same date makes the cumulative void amount 2,000 KRW, exceeding the original transaction, so both are error-processed)
- Cash receipt voids are batch-submitted to the NTS at 00:00 on D+1 following the request.
- Void results can be verified via the Issuance Error List Inquiry API after 13:00 on D+1.
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=insertReceiptInfoRequest 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.
1: Void└transNoAN(50)Alphanumeric, up to 50 bytes*Order number (unique merchant identifier).
Order number (unique merchant identifier).
*Use a newly generated order number, not the original order number. Duplicate order numbers are rejected regardless of date.
└ordNmAN(30)Alphanumeric, up to 30 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 to be voided in amt and the VAT in vat
Y (tax-exempt): enter the tax-free amount to be voided in amt and 0 in vat
G (mixed taxation): enter the taxable + tax-free amount to be voided in amt and the VAT on the taxable portion in vat (0 VAT is also valid)
For a full void, sending identityGb and identity as empty values voids using the cash receipt issuance data from the original transaction's approval number and approval datetime
For a partial void, send identityGb and identity as empty values and pass the calculated void amount
On void, the registration number type, registration number, tax type, supply value, VAT, service charge, sub-business registration number, and purpose type are reported to the NTS exactly as requested, so to void based on the original transaction, it is recommended to send identityGb and identity as empty values
Y (tax-exempt): enter the tax-free amount to be voided in amt and 0 in vat
G (mixed taxation): enter the taxable + tax-free amount to be voided in amt and the VAT on the taxable portion in vat (0 VAT is also valid)
For a full void, sending identityGb and identity as empty values voids using the cash receipt issuance data from the original transaction's approval number and approval datetime
For a partial void, send identityGb and identity as empty values and pass the calculated void amount
On void, the registration number type, registration number, tax type, supply value, VAT, service charge, sub-business registration number, and purpose type are reported to the NTS exactly as requested, so to void based on the original transaction, it is recommended to send identityGb and identity as empty values
└amtN(10)Numeric, up to 10 bytes*Void supply value.
Void supply value.
*Full void: original supply value; Partial void: supply value to be voided.
└vatN(10)Numeric, up to 10 bytes*Void VAT.
Void VAT.
*Full void: original VAT; Partial void: VAT to be voided.
└svcAmtN(10)Numeric, up to 10 bytesVoid service charge.
Void service charge.
└bizRegNoN(10)Numeric, up to 10 bytesSub-business registration number.
Sub-business registration number.
└purposeA(1)Alphabetic, up to 1 bytesPurpose type.
Purpose type.
0: Income deduction 1: Expense proof*Enter 0 (income deduction) when requesting with the self-issuance number
Recommended to send as empty for voids to use the original transaction data
Recommended to send as empty for voids to use the original transaction data
└identityGbA(1)Alphabetic, up to 1 bytesCash 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
Recommended to send as empty for voids (voided automatically using original transaction data)
Recommended to send as empty for voids (voided automatically using original transaction data)
└identityN(18)Numeric, up to 18 bytesCash receipt registration number.
Cash receipt registration number.
*Must be identical to the cash receipt registration number used at registration.
└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
└authNoAN(9)Alphanumeric, up to 9 bytes*Original transaction approval number.
Original transaction approval number.
*Approval number received during registration.
└orgTrDtAN(14)Alphanumeric, up to 14 bytes*Original transaction approval datetime (yyyyMMddHHmmss).
Original transaction approval datetime (yyyyMMddHHmmss).
*Value of trDt from the registration request.
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.
*Cash receipt registration was successful. (on success) / Error message (on failure, e.g., Order number is missing. - 1113)
└trTimeN(14)Numeric, up to 14 bytes*Issuance datetime.
20210316144124Issuance datetime.
*On void: API request datetime.
└authNoAN(9)Alphanumeric, up to 9 bytes*Approval number.
F67198300Approval number.
*Approval number of the voided cash receipt.
Request Example
Full Void Request (KRW 10,000)
https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo
&mid=mid_test
&assort=1
&transNo=CA20210316144124
&ordNm=
&trDt=20210316144124
&taxYn=N
&amt=9090
&vat=910
&svcAmt=
&bizRegNo=
&purpose=
&identityGb=
&identity=
&authNo=F67198300
&orgTrDt=20210316144106
Partial Void Request (KRW 5,000)
https://tcash.settlebank.co.kr/pgtrans/CashReceiptMultiAction.do?_method=insertReceiptInfo
&mid=mid_test
&assort=1
&transNo=CA20210316144125
&ordNm=
&trDt=20210316144125
&taxYn=N
&amt=4545
&vat=455
&svcAmt=
&bizRegNo=
&purpose=
&identityGb=
&identity=
&authNo=F67198300
&orgTrDt=20210316144106
Response Example
Success
{
"trTime": "20210316144124",
"resultCd": "0000",
"authNo": "F67198300",
"resultMsg": "Cash receipt registration was successful."
}
Failure
{
"trTime": "",
"resultCd": "1114",
"authNo": "",
"resultMsg": "The original transaction that was processed normally does not exist."
}
Request Result Codes
| Code | Message | Description |
|---|---|---|
| 0000 | Cash receipt registration was successful. | Successfully voided |
| 1000 | Cash receipt registration service is unavailable. | Not a cash receipt merchant |
| 1010 | Amount information is incorrect. Please check the card number. Please check the resident registration number. Please check the business registration number. Please check the mobile phone number. | Amount-related: incorrect amount information; Card number validation error; Resident registration number validation error; Business registration number validation error; Mobile phone number validation error |
| 1111 | Exception Message | System error |
| 1112 | Order number is missing. | transNo is empty |
| 1113 | A void with the same transNo/same amount already exists. | Duplicate void request |
| 1114 | The original transaction that was processed normally does not exist. | No original transaction found on void |
| 1115 | A previously registered transaction already exists. | Duplicate registration request |
| 1116 | The void amount exceeds the original transaction amount. | Void amount exceeded |
| 1117 | Required information is missing. | Required data missing |
| 1118 | Original transaction information for reprocessing does not exist. | No original transaction on reprocessing request |
| 1119 | This record is subject to auto-reprocessing. | Transaction is an auto-reprocessing target |
| 1120 | A reprocessing request already exists. | Duplicate reprocessing request |
| 1121 | Please check the parameters. | Parameter error |
| 2000 | Registered merchant not found. Please check your ID. | Merchant ID error |
Need technical support?
Code Samples
HectoFinancial GitHub