> For the complete documentation index, see [llms.txt](https://docs.pandablue.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pandablue.com/v1/deposits-api/api-codes.md).

# API Codes

Learn about the API Codes returned by our APIs

### Deposits Status Codes

These are the codes returned by the WEBSTATUS API.

| Code |                                                                                                                                 Status                                                                                                                                 | Description                                                                                        |
| :--: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | -------------------------------------------------------------------------------------------------- |
|   6  |                                                                                                                                   NA                                                                                                                                   | The deposit was not found.                                                                         |
|   7  | <img src="https://3883333839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff92vedEnowdVWbjM4Cmd%2Fuploads%2FRqitYbW1yuLXqPSzhlf9%2FUntitled%20Diagram.svg?alt=media&amp;token=64e3e0e0-88fd-4c59-b80f-a5aee5f2ffc9" alt="" data-size="original"> | The deposit is created with all the information required and it is awaiting on customer's payment. |
|   8  |      <img src="https://3883333839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff92vedEnowdVWbjM4Cmd%2Fuploads%2Fg145C0npuELGve94wchx%2FCANCELLED.svg?alt=media&amp;token=a05521d2-2433-44bc-ab08-1dbd29e75759" alt="" data-size="original">     | The deposit has been cancelled by the customer or it has been 7 days after the expiration.         |
|   9  |      <img src="https://3883333839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff92vedEnowdVWbjM4Cmd%2Fuploads%2FWHa3VEwYC1XiGhVcAaQ2%2FCOMPLETED.svg?alt=media&amp;token=e6e60abc-730a-4d44-9e2c-5d0dd27584df" alt="" data-size="original">     | The deposit has been completed and the money was credited to your account.                         |

{% hint style="success" %}
Use the [Deposit Status Endpoint](https://docs.directa24.com/v1/deposits-api/streamline-api/deposit-status-endpoint) to retrieve the status of a deposit.
{% endhint %}

### Refund Status Codes

These are the codes returned by the Refund Status API.

| Code |                                                                                                                                 Status                                                                                                                                 | Description                                                                        |
| :--: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ---------------------------------------------------------------------------------- |
|   0  | <img src="https://3883333839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff92vedEnowdVWbjM4Cmd%2Fuploads%2FRqitYbW1yuLXqPSzhlf9%2FUntitled%20Diagram.svg?alt=media&amp;token=64e3e0e0-88fd-4c59-b80f-a5aee5f2ffc9" alt="" data-size="original"> | The refund was created and it is being processed                                   |
|   1  |      <img src="https://3883333839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff92vedEnowdVWbjM4Cmd%2Fuploads%2FWHa3VEwYC1XiGhVcAaQ2%2FCOMPLETED.svg?alt=media&amp;token=e6e60abc-730a-4d44-9e2c-5d0dd27584df" alt="" data-size="original">     | The refund has been completed. Final status                                        |
|   2  |      <img src="https://3883333839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff92vedEnowdVWbjM4Cmd%2Fuploads%2Fg145C0npuELGve94wchx%2FCANCELLED.svg?alt=media&amp;token=a05521d2-2433-44bc-ab08-1dbd29e75759" alt="" data-size="original">     | The refund has been canceled manually or because of an error. Final status         |
|   3  |      <img src="https://3883333839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff92vedEnowdVWbjM4Cmd%2Fuploads%2FGdZ6GcVS8vdo4uaDRTMi%2FREJECTED.svg?alt=media&amp;token=53b67f2f-d7f3-4de5-9e65-0c5f1c422669" alt="" data-size="original">      | The refund was rejected or failed to reach the beneficiary's account. Final status |

### Payment types

| Code | Description                |
| :--: | -------------------------- |
|  00  | Online Bank Transfer (TEF) |
|  01  | Bank Deposit               |
|  02  | Voucher                    |
|  03  | Debit or Credit Card       |

### Error codes

| Code | Description                                                             | Action                                                                                                                                                                                                                                                                                                                                                                         |
| ---- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 300  | Invalid params + \[param name]                                          | Ask the user to re-enter the information related to that parameter                                                                                                                                                                                                                                                                                                             |
| 301  | Empty params + \[param name]                                            | The parameter must be included in the request and must not be empty. If the parameter contains information filled by the user, ask the user to fill the information. If the parameter is filled automatically on the merchant's side (x\_login, x\_trans\_key, x\_invoice, x\_iduser or control), there is an integration error. Please include this parameter in the request. |
| 302  | Invalid control string                                                  | Integration problem. Please see Control string instructions                                                                                                                                                                                                                                                                                                                    |
| 401  | Invalid credentials                                                     | Integration problem. Check in the merchant's panel which are the correct credentials. Staging and Production credentials are different                                                                                                                                                                                                                                         |
| 402  | Unregistered IP address                                                 | Whitelist the IP in the merchant's panels by going to Settings -> API Access (Notice the IPs for Deposits and Cashouts are different)                                                                                                                                                                                                                                          |
| 409  | Missing configuration for merchant account                              | Reach out to <merchants@directa24.com> and mention the error message shown                                                                                                                                                                                                                                                                                                     |
| 500  | Generic error                                                           | Internal error, please contact support                                                                                                                                                                                                                                                                                                                                         |
| 502  | User unauthorized                                                       | For further information go to section "Clients" option on the left menu                                                                                                                                                                                                                                                                                                        |
| 503  | User blacklisted                                                        | The user is known for committing fraud. You can ask this for review, find the client on the "Clients" option on the left menu, select the user and click on the three dots on the top right, and "Flag for review"                                                                                                                                                             |
| 504  | User unauthorized due to cadastral situation                            | Check the user's cadastral situation                                                                                                                                                                                                                                                                                                                                           |
| 505  | Country not found                                                       | Send a valid country ISO code. Click here to see the list of countries.                                                                                                                                                                                                                                                                                                        |
| 506  | Payment method not found                                                | The Payment Method Code sent on the x\_bank field isn't correct, or the Payment Method isn't enabled for your Merchant account (Use the get\_banks\_by\_country API to diagnose this)                                                                                                                                                                                          |
| 508  | The user limit has been exceeded: {TRANSACTION\|DAILY\|WEEKLY\|MONTHLY} | Check the user's limit on the panel under the "Clients" option on the left menu                                                                                                                                                                                                                                                                                                |
| 515  | Invalid amount                                                          | The amount does not reach the minimum limit of USD 2                                                                                                                                                                                                                                                                                                                           |
| 516  | Invalid invoice                                                         | For functions: newInvoice and refund, it means the invoice already exists. For functions: payment status and refund status, it means the invoice was not found.                                                                                                                                                                                                                |
| 517  | Invalid country                                                         | The country does not exists                                                                                                                                                                                                                                                                                                                                                    |
| 518  | Too many consecutive attempts for user (Velocity Check)                 | This happens when the user attempts to do many deposits in a short period of time, and isn't completing them                                                                                                                                                                                                                                                                   |
| 519  | Missing confirmation url                                                | Make sure you are sending the confirmation url in the request or that you have set a default one in the Panel (Settings -> API Access)                                                                                                                                                                                                                                         |
| 520  | Insufficient funds (applies for refund function)                        | The refund could not be processed due to insufficient funds. Contact us to increase the balance                                                                                                                                                                                                                                                                                |
| 530  | User greylisted                                                         | The user is banned because we detected suspicious activities. You can ask this for review, find the client on the "Clients" option on the left menu, select the user and click on the three dots on the top right, and "Flag for review"                                                                                                                                       |
| 601  | Currency not allowed for this country                                   | Send a valid currency. Click here to see the available currencies per country.                                                                                                                                                                                                                                                                                                 |
| 700  | Could not register user                                                 | Internal error, please contact support                                                                                                                                                                                                                                                                                                                                         |
| 701  | Could not make the deposit                                              | Internal error, please contact support                                                                                                                                                                                                                                                                                                                                         |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pandablue.com/v1/deposits-api/api-codes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
