Error Codes
Error codes returned by the Reporting & Querying calls — Deposit Query, Transaction Query, and Mirror Reporting.
Codes in the 83xx range are specific to query operations.
Query Errors
| Code | Message | When You See It |
|---|---|---|
1001 | INVALID SUBTYPE | SUBTYPE on a TYPE=Q request is not one of T, DL, or DI. |
8340 | NO RECORDS | Transaction Query returned no results matching your filters. Treat as an empty result, not an error. |
8341 | INVALID LASTDEP | The LASTDEP on a Deposit List request is malformed (non-numeric or wrong length). |
8342 | INVALID DEPNUM | The DEPNUM on a Deposit Info request is malformed. |
8343 | INVALID BLOCK | The BLOCK parameter is malformed or non-numeric. |
8344 | INVALID GATEREF | The GATEREF on a Deposit Info lookup is malformed. |
8345 | INVALID REFNUM or AUTHNUM | The REFNUM or AUTHNUM on a Deposit Info lookup is malformed. |
8346 | TRAN NOT FUNDED | A Deposit Info lookup matched a transaction that has not yet been funded. Wait until the funding cycle completes. |
8347 | TRAN NOT DEPOSITED / BLOCK OUT OF RANGE / DEPNUM NOT FOUND | Three distinct conditions share this code — check the TEXT field on the response: the transaction has not reached a deposit, the BLOCK number exceeds the deposit's block count, or the DEPNUM was not found. |
8348 | INVALID DEPNUM | The DEPNUM passed validation but does not exist for this terminal. (Different from 8342, which indicates a formatting error.) |
8615 | TRAN NOT FOUND | The GATEREF or REFNUM/AUTHNUM lookup did not match any transaction. |
How to Handle
8340— expected result for queries that return no matches. Render empty state in your UI.83xxvalidation errors (8341-8345) — your code is sending malformed parameters. Check the parameter name in the error message and fix the request format. See Deposit Query or Transaction Query for the valid shapes.8346and8347 TRAN NOT DEPOSITED— the transaction exists but hasn't been deposited yet. These are expected for recent transactions; retry after the nightly funding cycle.8347 BLOCK OUT OF RANGE— you've paged past the last block of transactions in this deposit. Stop paging.8347 DEPNUM NOT FOUNDand8348— the deposit number doesn't exist for this terminal. Check theDEPNUMwas returned by a recent Deposit List call for this same terminal.8615— the transaction lookup reference doesn't match any record. Check your inputs and confirm the transaction was processed on this terminal.
Updated 12 days ago
