> For the complete documentation index, see [llms.txt](https://docs.tarlanpayments.kz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tarlanpayments.kz/agws/prichina-otkloneniya-operacii.md).

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

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

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

```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>