Blog home
Guides
Cash Receipt API Testing: The Essential Checklist
17 must-run test cases for cash receipt registration, cancellation, and reprocessing — with expected results and verification points.
Financial Services Team
2025-03-12
7 min read

"Registration works fine — we haven't tested cancellation yet."
This comes up often during QA. It's easy to test the happy path for cash receipts and call it done. In production, though, cancellations, reprocessing, and error lookups are where things actually break.
This article walks through 17 essential test scenarios for the cash receipt API — with request values, expected outcomes, and verification points ready to use in your QA process.
API: Cash Receipt Registration
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| assort | 0 | Issue/cancel flag (0: issue) |
| taxTn | N | Tax type (N: taxable) |
| amt | 9090 | Supply price |
| vat | 910 | VAT amount |
Expected result: resultCd: 0000 — successful issuance
API: Cash Receipt Registration
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| taxYn | Y | Tax type (Y: tax-exempt) |
| amt | 10000 | Transaction amount |
Expected result: resultCd: 0000 — tax-exempt issuance successful
API: Cash Receipt Registration
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| taxYn | G | Tax type (G: mixed tax) |
| amt | 15000 | Supply price |
| vat | 500 | VAT amount |
Expected result: resultCd: 0000 — mixed-tax issuance successful
API: Cash Receipt Registration
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| taxYn | (empty) | Tax type not provided |
| amt | 10000 | Transaction amount |
Expected result: resultCd: 0000 — auto tax determination successful
API: Cash Receipt Registration
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| amt | rounded value | Amount with decimal |
| vat | rounded value | VAT with decimal |
Expected result: resultCd: 1010 — amount validation logic confirmed
API: Cash Receipt Registration
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| transNo | (empty) | Transaction number omitted |
Expected result: resultCd: 1112 — required field validation confirmed
Precondition: Registration CASE 1 completed successfully
API: Cash Receipt Registration
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| transNo | same as Registration CASE 1 | Duplicate transaction number |
Expected result: resultCd: 1115 — duplicate registration rejected
Precondition: A successfully issued receipt exists
API: Cash Receipt Cancellation
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| assort | 1 | Issue/cancel flag (1: cancel) |
| authNo | original authNo | Original transaction approval number |
| orgTrOt | original transaction details | Original transaction timestamp |
Expected result: resultCd: 0000 — full cancellation successful
Precondition: A successfully issued receipt exists
API: Cash Receipt Cancellation
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| assort | 1 | Issue/cancel flag (1: cancel) |
| amt | partial amount | Less than original amount |
Expected result: resultCd: 0000 — partial cancellation confirmed
Precondition: Partial cancellations have already been applied
API: Cash Receipt Cancellation
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| amt | excess amount | Greater than original amount |
Expected result: resultCd: 1116 — cancellation amount exceeded
API: Cash Receipt Status Inquiry
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| trDt | 20250312100000 | Issuance request timestamp (YYYYMMDDHHmmss) |
| assort | 0 | Issue/cancel flag (0: issue) |
Expected result
resultCd: 0001 or 0021API: Cash Receipt Status Inquiry
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| trDt | arbitrary value | Non-existent timestamp |
Expected result: resultCd: 1113 — no transaction found, trDt validation failure confirmed
Precondition: After 1:00 PM on the day following the transaction (D+1)
API: Cash Receipt Error List Inquiry
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| trDtGb | 1 | Lookup type (1: by transaction date) |
| trDt1 | 20250312 | Start date (YYYYMMDD) |
Expected result
resultCd: CSV or 2000Precondition: Before the D+1 cutoff time
API: Cash Receipt Error List Inquiry
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| trDt1 | date before D+1 cutoff | Outside the allowed lookup window |
Expected result: resultCd: 2001 — no results available
Precondition: An error record exists
API: Cash Receipt Reprocessing
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| reYn | Y | Reprocessing flag |
| reTrDt | original transaction timestamp | Original issuance timestamp |
| reAuthNo | original authNo | Original approval number |
Expected result: resultCd: 0000 — reprocessing successful
API: Cash Receipt Reprocessing
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| reYn | Y | Reprocessing flag |
| reAuthNo | invalid authNo | Non-existent approval number |
Expected result: resultCd: 1118 — original transaction not found
Precondition: Reprocessing request completed
API: Cash Receipt Reprocessing Result List
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| searGb | 1 | Lookup type |
Expected result: resultCd: CSV — result list retrieved, check for 00/09/99 statuses
Cash receipt APIs have more edge cases than happy paths. Cancellations, reprocessing, and error lookups happen regularly in production, which is why testing these scenarios before launch matters.
Use the 17 test cases in this guide as your QA checklist to ship a solid cash receipt integration.
Need technical support?
Code Samples
HectoFinancial GitHub