Разделы документации
Документация / Приём платежей
Статусы платежа
Жизненный цикл и финальные статусы
| Статус | Финальный | Что означает |
|---|---|---|
| CREATED | нет | Платёж создан, покупатель ещё не начал оплату. Ссылка payUrl не сгорает, пока оплата не начата; ненужный платёж можно отменить по API. |
| PENDING | нет | Покупатель начал оплату: выставлен счёт, показан QR или открыта страница банка. С этого момента на оплату отводится 20 минут. |
| SUCCESS | да | Оплачено. Заполняется paidAt, начисление появляется в балансе магазина. |
| FAILED | да | Оплата не прошла: отказ банка или отмена. Деньги не списаны; для повторной попытки создайте новый платёж. |
| EXPIRED | да | Время на оплату истекло. Для повторной попытки создайте новый платёж. |
| REFUNDED | да | Платёж возвращён покупателю после SUCCESS. Возвраты выполняются через поддержку TabPay. |
| CANCELED | да | Платёж отменён вами по API до начала оплаты (из статуса CREATED). Ссылка payUrl показывает покупателю экран «Счёт отменён», оплатить его нельзя. |
Жизненный цикл
CREATED, затем PENDING, затем один из финальных: SUCCESS, FAILED или EXPIRED. Из SUCCESS платёж может перейти в REFUNDED, из CREATED - в CANCELED (отмена по API, доступна только пока покупатель не начал оплату). Переходы назад невозможны: финальный статус не меняется (кроме SUCCESS в REFUNDED).
На каждый переход в финальный статус - включая REFUNDED после SUCCESS и CANCELED - ваш магазин получает вебхук. Обрабатывайте неизвестные вашему коду статусы безопасно: подтверждайте ответом 200 и логируйте - набор статусов может расширяться.