ДЕЙСТВУЮЩИЙ КОНТРАКТ

Справочник статусов заявки

Мерчант получает полное имя статуса в ответах создания, проверки, списка и callback. Короткий код приведён для общения с поддержкой и сопоставления с кабинетом трейдера.

Все статусы

Статус мерчанта	Код	Группа	Что означает
BRAND_NEW	BN	Активная	Реквизит назначен, заявка ожидает обработки трейдером.
IN_PROGRESS	IP	Активная	Трейдер взял заявку в работу. Финального результата ещё нет.
UNFINISHED_WITH_RECALCULATION	UR	Ожидает решения	Передана другая фактическая сумма. Это не финальный статус.
IN_DISPUTE	ID	Диспут	Диспут создан и ожидает решения. Это не финальный статус.
SUCCESSFULLY_FINISHED	SF	Успешно обработана	Подтверждена ожидаемая сумма. Финальная сумма находится в real_income.
AUTO_APPROVED	AA	Успешно обработана	Заявка автоматически подтверждена платформой.
AUTO_APPROVED_DISPUTE	AAD	Успешно обработана	Диспут автоматически принят платформой.
FINISHED_WITH_RECALCULATION	FR	Успешно обработана	Заявка завершена с перерасчётом; используйте фактическую сумму.
REQUISITES_NOT_FOUND	NF	Оплата не начата	Подходящий реквизит не найден. Создание возвращает синхронный 404.
TIME_OUT	TO	Неуспешно обработана	Срок заявки истёк либо активная заявка отменена мерчантом.
CANCELED_WITH_RECALCULATION	CR	Неуспешно обработана	Перерасчёт или диспут отклонён. При наличии оснований доступен новый диспут.
CANCELED	CANCELED	Неуспешно обработана	Трейдер отклонил новую заявку. При наличии подтверждения доступен диспут.

Жизненный цикл

flowchart LR
    BN[BRAND_NEW] --> SF[SUCCESSFULLY_FINISHED]
    BN --> C[CANCELED]
    BN --> IP[IN_PROGRESS]
    BN --> TO[TIME_OUT]
    BN --> AA[AUTO_APPROVED]
    IP --> UR[UNFINISHED_WITH_RECALCULATION]
    IP --> TO
    UR --> FR[FINISHED_WITH_RECALCULATION]
    UR --> CR[CANCELED_WITH_RECALCULATION]
    P[Обработанный результат] --> ID[IN_DISPUTE]
    ID --> FR
    ID --> CR
    ID --> AAD[AUTO_APPROVED_DISPUTE]

Реакция интеграции

Группа	Статусы	Действие мерчанта
Активные	BRAND_NEW, IN_PROGRESS	Показывать текущие реквизиты и ждать результат.
Ожидают решения	UNFINISHED_WITH_RECALCULATION, IN_DISPUTE	Не завершать платёж локально; ждать следующего состояния.
Успешные	SUCCESSFULLY_FINISHED, AUTO_APPROVED, AUTO_APPROVED_DISPUTE, FINISHED_WITH_RECALCULATION	Зачислить актуальный real_income в валюте заявки.
Неуспешные	REQUISITES_NOT_FOUND, TIME_OUT, CANCELED_WITH_RECALCULATION, CANCELED	Не зачислять платёж автоматически; сохранить результат и при необходимости открыть диспут.

Для REQUISITES_NOT_FOUND не ожидайте отдельный callback: результат приходит в ответе 404 на создание. Для остальных статусов состав callback зависит от настройки мерчанта в EasyTokenPay.

Callback может повториться или прийти позже

Сохраняйте последнее известное состояние по order_uuid. При сомнении запросите /api/v1/merchant/get_order_status/{order_id}/ и используйте ответ API как актуальное состояние.