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
| 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 contains non-digits or is longer than 5 digits. |
8342 | INVALID DEPNUM | The DEPNUM on a Deposit Info request contains non-digits or is longer than 5 digits. |
8343 | INVALID BLOCK | BLOCK contains non-digits or is longer than 4 digits. |
8344 | INVALID GATEREF | The GATEREF on a Deposit Info lookup is malformed. |
8345 | INVALID REFNUM / INVALID 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 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. |
8348 | INVALID DEPNUM | DEPNUM is shorter than 5 digits. Deposit numbers are always exactly 5 digits. |
8615 | TRAN NOT FOUND | The GATEREF or REFNUM/AUTHNUM lookup did not match any transaction. |
9975 | REPDB ERROR | The 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.
| Code | Message | When You See It |
|---|---|---|
1011 | INVALID AMT | AMT is malformed. Send dollars and cents with the decimal point (for example 125.00). |
1029 | INVALID AUTHNUM | AUTHNUM isn't exactly 6 letters or digits. |
1031 | INVALID REFNUM | REFNUM isn't 5-40 characters, or contains characters other than letters, digits, - and /. |
1036 | INVALID INV | INV isn't 5-20 characters, or contains characters other than letters, digits and -. |
1052 | INVALID STARTDATE / INVALID ENDDATE | The date isn't a valid YYYYMMDD value. |
1055 | INVALID LAST4 | LAST4 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. 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, or theDEPNUMdoesn't exist. If it happens onBLOCK=1, check theDEPNUM.8347 DEPNUM NOT FOUND— the deposit number doesn't exist for this merchant. Check theDEPNUMwas 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].
Updated 3 days ago
Did this page help you?
