Список сделок и их статусы

Общая информация

Каждая транзакция в системе имеет статус, который отражает её текущее состояние и этап обработки.
Статусы используются как для Pay-In, так и для Pay-Out операций и позволяют отслеживать жизненный цикл заявки от создания до финального результата.

Изменения статусов автоматически отправляются через webhook.

---

Статусы Pay-In транзакций

Ниже описаны все возможные состояния, через которые может проходить операция приёма платежа (Pay-In).

---

active

• Платёжная заявка создана и активна.
• Клиенту выданы реквизиты для оплаты.
• Ожидается поступление средств от клиента.
• После успешной оплаты статус обычно обновляется автоматически в течение короткого времени.

---

success

• Платёж успешно выполнен.
• Средства получены и зачислены на баланс.
• Операция завершена и считается успешной.

---

canceled

• Клиент не выполнил оплату в установленный срок.
• Заявка автоматически отменена системой.
• Время ожидания оплаты настраивается в параметрах аккаунта.

---

dispute

• По транзакции инициирован спор.
• Обычно возникает, если клиент предоставляет подтверждение оплаты.
• Операция передаётся на ручное рассмотрение службой поддержки.
• Автоматическая обработка временно приостанавливается.

success_changed

• Проверка успешно завершена.
• Итоговая сумма транзакции пересчитана на основе фактического платежа.
• После пересчёта операция подготавливается к финальному завершению.

---

Статусы Pay-Out транзакций

Для операций вывода средств (Pay-Out) используется отдельный начальный статус.

---

pending

• Заявка на выплату создана.
• Операция ожидает начала обработки системой или оператором.
• Это стартовый статус для Pay-Out транзакций.

---

active (Pay-Out)

• Выплата находится в процессе выполнения.
• Операция обрабатывается оператором или автоматизированной системой.
• Выполняется проверка реквизитов и отправка средств.

---

success (Pay-Out)

• Выплата успешно завершена.
• Средства отправлены по указанным реквизитам.
• Дополнительных действий не требуется.

---

canceled (Pay-Out)

• Выплата отменена.
• Возможные причины:
  • некорректные реквизиты;
  • невозможность зачисления средств;
  • ошибки, выявленные при проверке.

---

Важные особенности

• Статус транзакции может изменяться несколько раз в процессе обработки.
• Все изменения статусов отправляются через webhook.
• Обработка webhook-уведомлений должна быть идемпотентной.
• Бизнес-логику рекомендуется выполнять только после финальных статусов (success, success_changed или canceled).

---

Данный список статусов является основой для отслеживания состояния всех транзакций и корректной интеграции платёжных процессов.