> For the complete documentation index, see [llms.txt](https://docs.neox.vn/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.neox.vn/docs/disbursement/integration/error-codes.md).

# Error codes

### 1. System's error codes

<table><thead><tr><th width="139">Error code</th><th width="114.33333333333334">Status</th><th>Error description</th></tr></thead><tbody><tr><td>1</td><td>SUCCESS</td><td>Success.</td></tr><tr><td>2</td><td>FAILED</td><td>System error (default)</td></tr><tr><td>400</td><td>FAILED</td><td>Bad request.</td></tr><tr><td>401</td><td>FAILED</td><td>System error exception</td></tr><tr><td>403</td><td>FAILED</td><td>Forbidden</td></tr><tr><td>404</td><td>FAILED</td><td>Service is not found.</td></tr><tr><td>413</td><td>FAILED</td><td>The request entity too large</td></tr><tr><td>422</td><td>FAILED</td><td>Invalid token.</td></tr><tr><td>429</td><td>FAILED</td><td>System error. (Internal Error)</td></tr><tr><td>500</td><td>FAILED</td><td>System error. (Internal Service error)</td></tr><tr><td>501</td><td>FAILED</td><td>System error. (Exception on gateway)</td></tr><tr><td>502</td><td>FAILED</td><td>Bad gateway</td></tr><tr><td>503</td><td>FAILED</td><td>System error (Internal Request rejected)</td></tr><tr><td>504</td><td>FAILED</td><td>System error (Request timeout)</td></tr><tr><td>505</td><td>FAILED</td><td>System error (Processing failed on gateway)</td></tr><tr><td>514</td><td>FAILED</td><td>System error (Request is skipped)</td></tr></tbody></table>

### 2. Logic's error codes

<table><thead><tr><th width="128">Error code</th><th width="145.33333333333334">Status</th><th>Error description</th></tr></thead><tbody><tr><td>1</td><td>SUCCESS</td><td>Request/Transaction is successful.</td></tr><tr><td>99</td><td>PROCESSING</td><td>Transaction is processing.</td></tr><tr><td>2009</td><td>FAILED</td><td>Insufficient household account balance</td></tr><tr><td>2014</td><td>FAILED</td><td>Transaction amount exceeded</td></tr><tr><td>2015</td><td>FAILED</td><td>Invalid amount</td></tr><tr><td>2051</td><td>FAILED</td><td>Exceed the number of transactions in 1 request (200 trans/request)</td></tr><tr><td>2052</td><td>FAILED</td><td>Violation of NEOX policy.</td></tr><tr><td>2053</td><td>FAILED</td><td>Invalid request.</td></tr><tr><td>2054</td><td>FAILED</td><td>Disbursement service has not been activated.</td></tr><tr><td>2055</td><td>FAILED</td><td>RequestId already exists.</td></tr><tr><td>2056</td><td>FAILED</td><td>Duplicated transaction</td></tr><tr><td>2057</td><td>FAILED</td><td>The minimum value condition is not met.</td></tr><tr><td>2063</td><td>FAILED</td><td>Invalid currency.</td></tr><tr><td>3000</td><td>FAILED</td><td>An error occurred during the processing.</td></tr><tr><td>3400</td><td>FAILED</td><td>Account/Card number is invalid</td></tr><tr><td>3401</td><td>FAILED</td><td>Incorrect account/card information.</td></tr><tr><td>3402</td><td>FAILED</td><td>Account/Card does not support the transaction</td></tr><tr><td>3403</td><td>FAILED</td><td>Account/Card number is invalid.</td></tr><tr><td>3700</td><td>FAILED</td><td>Banking system error.</td></tr><tr><td>3709</td><td>FAILED</td><td>Transaction is rejected by the issuing bank.</td></tr><tr><td>3710</td><td>FAILED</td><td>Reject due to fraud suspicion.</td></tr><tr><td>3711</td><td>FAILED</td><td>Card/Account is transacted in unauthorized area.</td></tr><tr><td>3715</td><td>FAILED</td><td>Publisher not found.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.neox.vn/docs/disbursement/integration/error-codes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.