> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/help-center/ai-base/diagnostika-i-faq/errors-and-diagnostics.md).

# Ошибки и диагностика

## Для чего нужен раздел

Раздел помогает быстро понять, где искать причину проблемы: в настройках валюты, направлении, курсе, резерве, мерчанте, автовыплате, AML/KYC, email, Telegram, CRON, очередях, правах или публичном сайте.

## Когда использовать

Используйте этот раздел, когда клиент пишет “не могу создать заявку”, “не пришли реквизиты”, “курс неправильный”, “резерв неверный”, “заявка зависла”, “не приходит письмо”, “не работает Telegram”, “не прошла верификация”, “автовыплата не ушла”.

## Основные возможности

| Возможность                | Что означает простыми словами                   | Когда использовать                                |
| -------------------------- | ----------------------------------------------- | ------------------------------------------------- |
| Быстрая диагностика заявки | Проверка всей цепочки от формы до статуса       | Почти при любой жалобе клиента                    |
| Проверка валюты            | Валюта активна, поля и сеть настроены           | Если валюта не видна или поле реквизитов неверное |
| Проверка направления       | Пара активна, лимиты и курс настроены           | Если пара `BTC - USDT` не открывается             |
| Проверка курса             | Источник, формула, BestChange или файл работают | Если клиент видит неверный курс                   |
| Проверка резерва           | Резерв связан и достаточно средств              | Если заявка не создаётся из-за резерва            |
| Проверка мерчанта          | Приём оплаты выдаёт реквизиты                   | Если клиент не получил реквизиты                  |
| Проверка автовыплаты       | Выплата клиенту разрешена и проходит            | Если заявка оплачена, но выплата не ушла          |
| Проверка AML/KYC           | Риск и верификация не блокируют сценарий        | Если система требует проверку или отклоняет       |
| Проверка уведомлений       | Email и Telegram включены и настроены           | Если клиент или админ не получают сообщения       |
| Проверка прав              | У администратора есть доступ                    | Если сотрудник не видит кнопку или раздел         |

## Поля и настройки

| Поле / настройка      | Что означает                   | Как правильно заполнять                                  | Важно знать                                                               |
| --------------------- | ------------------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------- |
| ID заявки             | Главный идентификатор проблемы | Просите у клиента номер заявки                           | По нему ищутся статусы, логи, мерчант, AML                                |
| Пара обмена           | Например `BTC - USDT`          | Записывайте валюты в формате “Отдаю - Получаю”           | Не путайте направление с обратной парой                                   |
| Сумма отдаю / получаю | Суммы из формы или заявки      | Сравнивайте с лимитами направления                       | Ошибка часто в min/max                                                    |
| Статус заявки         | Текущее состояние заявки       | Смотрите в карточке заявки                               | От статуса зависит доступность действий                                   |
| Источник курса        | Откуда берётся курс            | Проверьте направление и парсер                           | Если источник пустой, курс может быть ручным                              |
| Резерв                | Доступный остаток валюты       | Сравните с суммой заявки                                 | Резерв может быть ограничен настройками отображения                       |
| Мерчант               | Приём оплаты                   | Проверьте валюту, направление и журналы платежных шлюзов | Мерчант может быть выбран автоматически                                   |
| Автовыплата           | Выплата клиенту                | Проверьте статус “оплачена”, лимиты и шлюз               | Не все статусы разрешают выплату                                          |
| AML-сервис            | Провайдер проверки риска       | Проверьте активность и поля подключения                  | Без сервиса проверка не выполнится                                        |
| KYC-сервис            | Провайдер проверки личности    | Проверьте настройки сервиса и правила                    | Может быть ручная форма                                                   |
| CRON / очередь        | Фоновые процессы               | Проверьте последний успешный запуск                      | В админке настройка может быть включена, но обработчик очереди остановлен |

## Как настроить

1. Сначала определите тип проблемы: форма, курс, резерв, оплата, выплата, уведомление, доступ или проверка.
2. Найдите заявку или направление.
3. Проверьте валюты “Отдаю” и “Получаю”: статус, сеть, поля, реквизиты, AML/KYC.
4. Проверьте направление: статус, лимиты, курс, комиссии, резервы, мерчант, выплаты.
5. Проверьте логи: статусы заявки, реквизиты, AML, история оплаты, журналы платежных шлюзов.
6. Проверьте CRON и очереди, если проблема связана с задержкой.
7. Проверьте публичный сайт: видит ли клиент актуальную пару, поля, лимиты и понятную ошибку.
8. После исправления повторите сценарий на тестовой или небольшой заявке.

## Типовые ошибки

| Ошибка / ситуация              | Причина                                                                                 | Что сделать                                            |
| ------------------------------ | --------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| Валюта не отображается         | Валюта выключена, в архиве, не в фильтре или нет активного направления                  | Проверить валюту, фильтры и направление                |
| Направление не отображается    | Направление выключено, лимиты не подходят, нет резерва или курс не рассчитан            | Проверить статус, лимиты, резерв и курс                |
| Клиент не может создать заявку | Не заполнено обязательное поле, неверный реквизит, CAPTCHA, антиспам, KYC/AML, лимит    | Посмотреть ошибку формы и настройки направления        |
| Реквизиты не выданы            | Не настроен мерчант, лимиты, сеть, валидатор или резерв реквизитов                      | Проверить валюту, направление, мерчант и логи          |
| Курс неправильный              | Источник устарел, формула неверна, BestChange пустой, файл не обновился                 | Проверить источник курса и историю обновления          |
| Заявка зависла в оплате        | Клиент не оплатил, мерчант не прислал уведомление провайдера, проверка оплаты не прошла | Проверить история оплаты и вручную проверить платёж    |
| Автовыплата не ушла            | Статус не подходит, лимит превышен, автовыплата выключена, ошибка шлюза                 | Проверить настройки выплаты и журналы платежных шлюзов |
| AML требует действие           | Риск выше порога или включена ошибка при превышении риска                               | Проверить AML-логи и правила валюты                    |
| KYC не запускается             | Не выбран сервис, правило не включено или нет формы                                     | Проверить KYC-сервис и правила валюты/направления      |
| Email не приходит              | Почта не настроена, шаблон выключен, очередь стоит                                      | Проверить email-настройки, тестовую отправку и очередь |
| Telegram не приходит           | Канал не привязан, бот не имеет прав, уведомление выключено                             | Проверить канал, bind/check и шаблон                   |
| Админ не видит кнопку          | Нет права в роли                                                                        | Проверить роль и permission                            |

## Важные предупреждения

Не исправляйте финансовые проблемы “на глаз”. Если речь о деньгах, сначала соберите факты: заявка, статус, сумма, курс, реквизиты, логи мерчанта, логи статусов, AML/KYC, операторские комментарии. Только после этого меняйте статус или делайте выплату.

Не отправляйте клиенту сырые ответы API, логи, токены, ID внутренних провайдеров или технические stack traces. Клиенту нужен понятный ответ: что произошло, что проверяется, что нужно от клиента и какой следующий шаг.

## Связанные разделы

Заявки, Валюты, Направления, Курсы, Резервы, AML, KYC, Платёжные системы, Email, Telegram, Логи, CRON и процессы, Роли и доступ.


---

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

```
GET https://docs.iexexchanger.com/help-center/ai-base/diagnostika-i-faq/errors-and-diagnostics.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.
