# Причина отклонения операции

**Причина отклонения операции** описывает обстоятельства или условия, из-за которых  операция не был успешно завершен. Это может включать ошибки пользователя (например, недостаточно средств), проблемы с верификацией или ограничения на стороне платежной системы или банка.

Структура поля:

```json
"fail_reason": {
    "code": 100,
    "message": "Unknown reason, clarification required"
}
```

Причина отклонения платежа, передаются как доп. параметры в следующих методах:

* [Callback платежной системы ](/agws/callback-platezhnoi-sistemy.md)

```json
{
    "project": "Testing",
    "service_code": "70958",
    "external_id": "proident",
    "status_code": "4",
    "status_message": "Transaction was failed",
    "amount": 100.82,
    "datetime": "2022-12-01T15:45:00Z",
    "username": "enim",
    "fail_reason": {
        "code": 100,
        "message": "Unknown reason, clarification required"
    }
}
```

* [Проверка статуса пополнения](/agws/proverka-statusa-popolneniya.md)

```json
{    
    "status": true,
    "status_code": 0,
    "message": "Success",
    "result":{
        "error_code" : 0,
        "message": "",
        "data": {
            "status_code": "4",
            "status_message": "Transaction was failed",
            "username": "989898",
            "amount": 100,
            "datetime": "2022-12-01T15:45:00Z",
            "project": "mobile",
            "fail_reason": {
                "code": 100,
                "message": "Unknown reason, clarification required"
            }
            "service_code": "201106",
            "external_id": "200001",
        }
}
```

* [Проверка состояния аккаунта](/agws/proverka-sostoyaniya-akkaunta.md)

```json
 {
    "status": true,
    "status_code": 0,
    "message": "Success",
    "result": {
        "error_code": 0,
        "message": "This account is inactive",
        "account_status": 0,
        "fail_reason": {
            "code": 100,
            "message": "Unknown reason, clarification required"
        },
        "info": {
            "parking": {
                "in_date": "2024-08-02T12:24:07+05:00",
                "left_free_time_minutes": 0,
                "sum": 118,
                "current_balance": -1
            }
        }
    }
}
```

* [Проведение платежа](/agws/provedenie-platezha.md), передаются при статусе [<mark style="color:blue;">Transaction was failed</mark>](/agws/statusy-tranzakcii.md)

```json
{
    "status": true,
    "status_code": 0,
    "message": "Success",
    "result": {
        "error_code": 0,
        "message": "",
        "data": {
            "status_code": "4",
            "status_message": "Transaction was failed",
            "username": "12345",
            "amount": 1000,
            "datetime": "2024-01-01T00:00:00",
            "project": "project",
            "service_code": "service",
            "external_id": "200001",
            "fail_reason": {
                "code": 100,
                "message": "Unknown reason, clarification required"
        },
        }
    }
}
```

* [Подтверждение списания средств](/agws/podtverzhdenie-spisaniya-sredstv.md), передаются при статусе [<mark style="color:blue;">Transaction was failed</mark>](/agws/statusy-tranzakcii.md)

```json
{
    "status": true,
    "status_code": 0,
    "message": "Success",
    "result": {
        "is_success": true,
        "transaction_status_id": "4",
        "external_id": "200001",
        "message": "",
        "otp_status": false,
        "fail_reason": {
            "code": 402,
            "message": "Incorrect confirmation code"
        }
    }
}
```

<table data-full-width="true"><thead><tr><th>code</th><th width="286">message</th><th>Описание</th></tr></thead><tbody><tr><td>100</td><td>Unknown reason, clarification required</td><td>Неизвестная причина, необходимо уточнение</td></tr><tr><td>101</td><td>Error on the service provider side</td><td>Ошибка на стороне поставщика услуг</td></tr><tr><td>102</td><td>Request validation error</td><td>Ошибка валидации запроса</td></tr><tr><td>103</td><td>A payment with the specified ID already exists in the system</td><td>платеж с указанным идентификатором уже присутствует в системе</td></tr><tr><td>104</td><td>Transaction with the specified ID is not found in the system</td><td>транзакция с указанным идентификатором отсутствует в системе</td></tr><tr><td>105</td><td>Authorization error</td><td>Ошибка авторизации</td></tr><tr><td>106</td><td>Verification via the provider's server is unavailable. You can make a payment if you are confident in the parameters</td><td>Проверка через сервер поставщика недоступна</td></tr><tr><td>107</td><td>Transaction failed by timeout</td><td>Операция была отклонена по истечению времени жизни</td></tr><tr><td>200</td><td>Insufficient balance</td><td>Недостаточно баланса</td></tr><tr><td>201</td><td>Invalid ID format</td><td>Неверный формат идентификатора</td></tr><tr><td>202</td><td>Unverified account</td><td>Неверифицированный аккаунт</td></tr><tr><td>203</td><td>Phone number not available for top-up</td><td>Номер телефона, недоступный для пополнения</td></tr><tr><td>204</td><td>Operation limit exceeded for a user with simplified identification</td><td>Превышение лимита по операции для упрощенно идентифицированного пользователя</td></tr><tr><td>205</td><td>Operation limit exceeded for an identified user</td><td>Превышение лимита по операции для идентифицированного пользователя</td></tr><tr><td>206</td><td>Operation limit exceeded for an unidentified user</td><td>Превышение лимита по операции для не идентифицированного пользователя</td></tr><tr><td>207</td><td>Invoices are not yet generated. The provider may generate new month invoices during a period when they cannot be obtained.</td><td>Инвойсы ещё не сформированы</td></tr><tr><td>300</td><td>The payment amount is too large</td><td>Слишком большое значение суммы платежа</td></tr><tr><td>301</td><td>Limit exceeded</td><td>Превышение лимита</td></tr><tr><td>302</td><td>Incorrect payment amount</td><td>Некорректная сумма платежа</td></tr><tr><td>303</td><td>The payment amount is less than the minimum value</td><td>Сумма платежа меньше установленного значения</td></tr><tr><td>304</td><td>Amount out of acceptable range</td><td>Сумма вне допустимого диапазона</td></tr><tr><td>400</td><td>Receiving two confirmation requests for the same operation with a minimal interval</td><td>Получение 2 запросов на подтверждение одной операции с минимальным интервалом</td></tr><tr><td>401</td><td>Transaction lifespan expired</td><td>Истек срок жизни транзакции</td></tr><tr><td>402</td><td>Incorrect confirmation code</td><td>Неверный код подтверждения</td></tr><tr><td>403</td><td>The service has already been paid</td><td>Услуга уже была оплачена</td></tr><tr><td>404</td><td>The specified zone does not exist</td><td>Указанная зона не существует</td></tr><tr><td>405</td><td>The specified zone is inactive</td><td>Указанная зона не активна</td></tr><tr><td>406</td><td>A parameter required for payment is missing</td><td>Пропущен параметр для оплаты</td></tr><tr><td>407</td><td>Exceeded the number of confirmation code attempts</td><td>Превышено количество попыток ввода кода подтверждения</td></tr></tbody></table>


---

# Agent Instructions: 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:

```
GET https://docs.tarlanpayments.kz/agws/prichina-otkloneniya-operacii.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.