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.
Are you actually testing your cash receipt integration?
"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.
1. Registration tests
Registration CASE 1: Standard taxable issuance
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
Registration CASE 2: Tax-exempt 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
Registration CASE 3: Mixed-tax issuance
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
Registration CASE 4: Automatic tax determination
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
2. Registration failure validation
Validation CASE 1: Rounded amount check
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
Validation CASE 2: Missing required field
API: Cash Receipt Registration
Key parameters:
| Parameter | Value | Description |
|---|---|---|
| transNo | (empty) | Transaction number omitted |
Expected result: resultCd: 1112 — required field validation confirmed
Validation CASE 3: Duplicate registration blocked
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
3. Cancellation tests
Cancellation CASE 1: Full cancellation
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
Cancellation CASE 2: Partial cancellation
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
Cancellation CASE 3: Cancellation exceeds original amount
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
4. Status inquiry
Status inquiry CASE 1: Successful lookup
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:0001or0021- Verification point: Status confirmed
Status inquiry CASE 2: Transaction not found
API: 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
5. Error inquiry
Error inquiry CASE 1: D+1 lookup
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:CSVor2000- Verification point: Error list present or empty
Error inquiry CASE 2: Time restriction
Precondition: 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
6. Reprocessing
Reprocessing CASE 1: Successful reprocessing
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
Reprocessing CASE 2: Original transaction not found
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
Reprocessing CASE 3: Result lookup
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
7. Test checklist
Must Have
- Registration CASE 1: Standard taxable issuance
- Registration CASE 2: Tax-exempt issuance
- Registration CASE 3: Mixed-tax issuance
- Cancellation CASE 1: Full cancellation
- Validation CASE 3: Duplicate registration blocked
- Status inquiry CASE 1: Successful lookup
Should Have
- Registration CASE 4: Automatic tax determination
- Validation CASE 1: Rounded amount check
- Validation CASE 2: Missing required field
- Cancellation CASE 2: Partial cancellation
- Cancellation CASE 3: Cancellation exceeds original amount
- Error inquiry CASE 1: D+1 lookup
- Reprocessing CASE 1: Successful reprocessing
Nice to Have
- Status inquiry CASE 2: Transaction not found
- Error inquiry CASE 2: Time restriction
- Reprocessing CASE 2: Original transaction not found
- Reprocessing CASE 3: Result lookup
Wrapping up
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