> 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/guide/zayavki/upravlenie-zayavkami/etapy-dlya-zayavok.md).

# Этапы для Заявок

Модуль «Этапы заявок» предназначен для наглядного отображения процесса обработки заявки. Он помогает клиенту понимать, на каком шаге находится обмен, а оператору — визуально контролировать текущий этап выполнения.

Этапы являются дополнительным инструментом визуализации и не заменяют статусы заявки.

## Чем этап отличается от статуса

Очень важно понимать разницу между этапами и статусами.

| Статусы заявки                                                           | Этапы заявки                                                          |
| ------------------------------------------------------------------------ | --------------------------------------------------------------------- |
| Используются системой для логики работы                                  | Используются для отображения процесса                                 |
| Управляют оплатой, резервами, выплатами и уведомлениями                  | Показывают клиенту текущий шаг обработки                              |
| Влияют на работу мерчантов и автоматических выплат                       | Не влияют на финансовую логику                                        |
| Используются в аналитике и статистике                                    | Используются для удобства отображения                                 |
| Например: «Ожидается оплата», «Оплаченная заявка», «Ошибка авто-выплаты» | Например: «Подготовка оплаты», «Проверка платежа», «Обработка заявки» |

Пример:

Внутри системы заявка может последовательно иметь статусы:

* В процессе оплаты
* Проверка оплаты
* Подтверждение от мерчанта

При этом клиент может видеть всего один этап: **Проверка платежа**

Таким образом клиенту показывается понятный процесс без технических деталей.

## Для чего нужны этапы

Этапы позволяют:

* показать клиенту понятный прогресс заявки;
* скрыть технические статусы системы;
* объединить несколько внутренних статусов в один шаг;
* повысить прозрачность процесса обмена;
* отображать ход обработки в личном кабинете;
* использовать разные сценарии для разных направлений обмена;
* вручную управлять этапами в карточке заявки.

***

Для управления этапами откройте: **«Заявки» — «Этапы заявок»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-6e80b5fd303d61eb8be8dcbbadf1618ce394aad0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

В данном разделе отображается список всех этапов системы.

## Основные этапы по умолчанию

В большинстве обменных пунктов используется следующая схема.

<table><thead><tr><th width="237.0703125">Этап</th><th>Назначение</th></tr></thead><tbody><tr><td>Подготовка оплаты</td><td>Клиент получил реквизиты и должен выполнить оплату</td></tr><tr><td>Проверка платежа</td><td>Платёж проверяется системой или оператором</td></tr><tr><td>Обработка заявки</td><td>Оплата подтверждена и заявка обрабатывается</td></tr><tr><td>Исполнено</td><td>Обмен полностью завершён</td></tr></tbody></table>

Этого набора достаточно для большинства направлений обмена.

## Роли этапов

Каждый этап имеет специальную роль.

{% stepper %}
{% step %}

### Стартовый этап

Это первый этап сценария.

На него заявка попадает сразу после создания.

Пример: **Подготовка оплаты**
{% endstep %}

{% step %}

### Обычный этап

Промежуточный этап между началом и завершением.

Примеры: **Проверка платежа**
{% endstep %}

{% step %}

### Финальный этап

Последний этап сценария.

После него процесс считается завершённым.

Пример: **Исполнено**
{% endstep %}
{% endstepper %}

## Добавление нового этапа

Для создания нового этапа:

Перейдите: **«Заявки» — «Этапы заявок»**

Нажмите кнопку: **«Добавить этап»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-76133c0b777b1d21b3677d77ae84553e96fc429c%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

После этого заполните поля.

<table><thead><tr><th width="177.76171875">Поле</th><th>Описание</th></tr></thead><tbody><tr><td>Название</td><td>Название этапа</td></tr><tr><td>Статус</td><td>Включён или выключен</td></tr></tbody></table>

После сохранения этап появится в общем списке.

{% stepper %}
{% step %}

## Название этапа

Название должно быть понятным клиенту.

Хорошие примеры:

* Подготовка оплаты
* Проверка платежа

Не рекомендуется использовать технические названия:

* Callback received
* Merchant verification

Клиент должен понимать этап без дополнительных пояснений.
{% endstep %}

{% step %}

### Активность этапа

**Включён**

Этап участвует в работе системы.

Оператор может выбирать его в карточке заявки.

Клиент может видеть его в истории обработки.

**Выключен**

Этап сохраняется в системе, но больше не используется.

Это удобно, если этап временно не нужен, но его нельзя удалить из-за старых заявок.
{% endstep %}

{% step %}

### Показ клиенту

Для каждого этапа отдельно настраивается видимость.

**Показывать клиенту**

Этап отображается:

* в личном кабинете;
* в карточке заявки;
* в прогрессе обработки.

**Скрыть от клиента**

Этап используется только внутри админ-панели.

Клиент его не увидит.

Это удобно для внутренних этапов операторов.

Например: **Дополнительная проверка AML**
{% endstep %}
{% endstepper %}

## Сортировка этапов

Этапы можно менять местами с помощью перетаскивания.

Порядок определяет последовательность отображения клиенту.

## Использование этапов в карточке заявки

В карточке заявки отображается блок: **Этап заявки**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-16142b605e6a4edcaebb5f4950b2de937a2f22c1%2Fimage.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

Оператор может выбрать любой активный этап из списка.

Например: **Подготовка оплаты**

После выбора изменения сохраняются сразу.

## Автоматическая смена этапов

Система может автоматически изменять этап в зависимости от статуса заявки.

Пример стандартной логики:

<table><thead><tr><th width="269.72265625">Статус заявки</th><th>Этап</th></tr></thead><tbody><tr><td>Ожидается оплата</td><td>Подготовка оплаты</td></tr><tr><td>В процессе оплаты</td><td>Проверка платежа</td></tr><tr><td>Проверка оплаты</td><td>Проверка платежа</td></tr><tr><td>Подтверждение от мерчанта</td><td>Проверка платежа</td></tr><tr><td>Оплаченная заявка</td><td>Обработка заявки</td></tr><tr><td>Ожидает обработки</td><td>Обработка заявки</td></tr><tr><td>Выплата в процессе</td><td>Обработка заявки</td></tr><tr><td>Заявка исполнена</td><td>Исполнено</td></tr></tbody></table>

Таким образом оператор меняет только статус, а этап обновляется автоматически.

## Ручная смена этапов

При необходимости оператор может изменить этап вручную.

Это полезно если:

* используется нестандартный процесс обработки;
* нужно показать клиенту другой шаг;
* требуется дополнительное информирование клиента;
* автоматическая логика не подходит для конкретной заявки.

## Где отображаются этапы

{% stepper %}
{% step %}

### Для клиента

Если этап публичный и включено отображение этапов для валюты, клиент увидит:

* текущий этап;
* последовательность этапов;
* прогресс обработки заявки.
  {% endstep %}

{% step %}

### Для оператора

В карточке заявки оператор видит:

* текущий этап;
* список доступных этапов;
* возможность изменить этап вручную.
  {% endstep %}
  {% endstepper %}

## Включение этапов для клиентов

Чтобы клиент видел этапы, необходимо включить отображение у валюты.

Откройте: **«Основное» — «Валюты» — «Список валют»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-d5235ff777dc2e3cdf1ed2b6a3e6cb7acdb2ea93%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Выберите нужную валюту и перейдите: **«Дополнительное» — «Другие опция»**

Включите параметр: **Отображение этапов в карточке заявок**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-d0412301d4cd1d76f370d178569b6b2fc4fe5c8d%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Если настройка выключена, клиент не увидит этапы даже при наличии активного сценария.

## История изменения этапов

Система фиксирует все изменения этапов.

Для каждого перехода сохраняется:

* предыдущий этап;
* новый этап;
* дата изменения;
* оператор;
* способ изменения (ручной или автоматический).

Это помогает контролировать процесс обработки и разбирать спорные ситуации.

## Рекомендуемая схема этапов

Для большинства обменников рекомендуется использовать следующую структуру.

| Роль      | Название          |
| --------- | ----------------- |
| Стартовый | Подготовка оплаты |
| Обычный   | Проверка платежа  |
| Обычный   | Обработка заявки  |
| Финальный | Исполнено         |

Такая схема понятна клиентам и подходит практически для любых направлений обмена.

## Что можно делать в разделе

В разделе **«Этапы заявок»** доступно:

* просмотр списка этапов;
* создание новых этапов;
* изменение названия этапа;
* включение и отключение этапов;
* настройка отображения клиенту;
* изменение порядка этапов;
* удаление неиспользуемых этапов;
* ручное управление этапами в карточке заявки.