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

CodeMessageWhen You See It
1001INVALID SUBTYPESUBTYPE on a TYPE=Q request is not one of T, DL, or DI.
8340NO RECORDSTransaction Query returned no results matching your filters. Treat as an empty result, not an error.
8341INVALID LASTDEPThe LASTDEP on a Deposit List request is malformed (non-numeric or wrong length).
8342INVALID DEPNUMThe DEPNUM on a Deposit Info request is malformed.
8343INVALID BLOCKThe BLOCK parameter is malformed or non-numeric.
8344INVALID GATEREFThe GATEREF on a Deposit Info lookup is malformed.
8345INVALID REFNUM or AUTHNUMThe REFNUM or AUTHNUM on a Deposit Info lookup is malformed.
8346TRAN NOT FUNDEDA Deposit Info lookup matched a transaction that has not yet been funded. Wait until the funding cycle completes.
8347TRAN NOT DEPOSITED / BLOCK OUT OF RANGE / DEPNUM NOT FOUNDThree 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.
8348INVALID DEPNUMThe DEPNUM passed validation but does not exist for this terminal. (Different from 8342, which indicates a formatting error.)
8615TRAN NOT FOUNDThe 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.
  • 83xx validation 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.
  • 8346 and 8347 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 FOUND and 8348 — the deposit number doesn't exist for this terminal. Check the DEPNUM was 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.