Статусы и типы операций

Перечень статусов, допустимые переходы и типы операций

Статусы операций

Перечень статусов является общим для всех типов операций и режимов интеграции.

Статус	Финальный	Описание
`created`	нет	операция создана, ожидается действие конечного клиента или провайдера
`precreated`	нет	операция платёжной формы создана, метод оплаты не выбран
`booking`	нет	реквизиты зарезервированы у провайдера, ожидается подтверждение
`in_progress`	нет	операция в процессе обработки провайдером
`pending_retry`	нет	операция Pay Out поставлена в очередь повторной отправки
`success`	да	операция успешно завершена
`failed`	да	операция отклонена провайдером или антифрод‑контролем

Допустимые переходы

Операции Pay In в режиме host‑to‑host

created → in_progress → success
                     └→ failed

При резервировании реквизитов между created и in_progress присутствует промежуточный статус booking.

Операции Pay In в режиме платёжной формы (prepare)

precreated → created → in_progress → success
                                  └→ failed

Операции Pay Out

created → in_progress → success
       └→ pending_retry → in_progress → success
                                     └→ failed

Статус pending_retry означает, что операция не была принята провайдером и поставлена в очередь повторной отправки. Создание повторной операции с другим значением idTransactionMerchant не требуется и приводит к нарушению учёта на стороне мерчанта.

Правила принятия решений

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

Типы операций

Значения поля typeOperation:

Значение	Описание	Источник создания
`payIn`	приём платежа от клиента	API мерчанта
`payOut`	выплата клиенту	API мерчанта
`balanceReplenishment`	ручное пополнение баланса мерчанта	внутренний процесс платформы
`balanceWithdrawal`	ручной вывод баланса мерчанта	внутренний процесс платформы
`providerSettle`	settlement средств от провайдера	внутренний процесс платформы
`providerVirtualSettle`	виртуальный settlement провайдера	внутренний процесс платформы
`merchantSettle`	вывод средств фиатного мерчанта	внутренний процесс платформы
`merchantVirtualSettle`	виртуальный settlement мерчанта	внутренний процесс платформы
`correct`	корректировка баланса	административная операция

Операции типов correct, providerSettle, providerVirtualSettle, merchantSettle, merchantVirtualSettle могут присутствовать в результате POST /operation/operation/list, однако не формируют события webhook.