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. Malformed filter fields return the standard field-validation codes listed under Field Validation.

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 contains non-digits or is longer than 5 digits.
8342INVALID DEPNUMThe DEPNUM on a Deposit Info request contains non-digits or is longer than 5 digits.
8343INVALID BLOCKBLOCK contains non-digits or is longer than 4 digits.
8344INVALID GATEREFThe GATEREF on a Deposit Info lookup is malformed.
8345INVALID REFNUM / INVALID 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 conditions share this code, so check TEXT: the transaction hasn't reached a deposit yet; BLOCK is past the last block of the deposit; or the deposit doesn't exist. With BLOCK of 1 or more (or omitted), a DEPNUM that doesn't exist returns BLOCK OUT OF RANGE; DEPNUM NOT FOUND is returned only with BLOCK=0.
8348INVALID DEPNUMDEPNUM is shorter than 5 digits. Deposit numbers are always exactly 5 digits.
8615TRAN NOT FOUNDThe GATEREF or REFNUM/AUTHNUM lookup did not match any transaction.
9975REPDB ERRORThe reporting database couldn't be reached. Retry the query shortly.

Field Validation

Transaction Query filters are validated before the search runs. A malformed filter returns one of these codes.

CodeMessageWhen You See It
1011INVALID AMTAMT is malformed. Send dollars and cents with the decimal point (for example 125.00).
1029INVALID AUTHNUMAUTHNUM isn't exactly 6 letters or digits.
1031INVALID REFNUMREFNUM isn't 5-40 characters, or contains characters other than letters, digits, - and /.
1036INVALID INVINV isn't 5-20 characters, or contains characters other than letters, digits and -.
1052INVALID STARTDATE / INVALID ENDDATEThe date isn't a valid YYYYMMDD value.
1055INVALID LAST4LAST4 isn't exactly 4 digits.

How to Handle

  • 8340 — expected result for queries that return no matches. Render empty state in your UI.
  • Validation errors (1011, 1029, 1031, 1036, 1052, 1055, 8341-8345, 8348) — 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, or the DEPNUM doesn't exist. If it happens on BLOCK=1, check the DEPNUM.
  • 8347 DEPNUM NOT FOUND — the deposit number doesn't exist for this merchant. Check the DEPNUM was returned by a recent Deposit List call for the same terminal.
  • 8615 — the transaction lookup reference doesn't match any record. Check your inputs and confirm the transaction was processed on this terminal.
  • 9975 — temporary reporting database problem. Retry shortly; if it persists, contact [email protected].

Did this page help you?