Статусы счёта
Жизненный цикл счёта линейный и короткий: из created через pending в один из финальных статусов. Финальный статус меняется только возвратом.
API v1 · обновлено 2026-09-12
Диаграмма переходов
Текстом: created → pending → paid | failed | expired; затем paid → refunded | partially_refunded. Переход created → expired тоже возможен, если покупатель так и не открыл страницу до истечения срока.
Справочник
| Статус | Описание | Финальный? | Вебхук |
|---|---|---|---|
| created | Счёт создан через API или кабинет. Покупатель ещё не открыл страницу оплаты. | нет | — |
| pending | Покупатель открыл страницу и выбрал способ; платёж в обработке у банка. | нет | — |
| paid | Оплата подтверждена, сумма зачислена на баланс. | да | invoice.paid |
| failed | Банк или покупатель отклонил платёж. | да | invoice.failed |
| expired | Истёк срок оплаты (expire), платежа не было. | да | invoice.expired |
| partially_refunded | Покупателю возвращена часть суммы; остаток остаётся у мерчанта. | да | refund.succeeded |
| refunded | Покупателю возвращена вся сумма счёта. | да | refund.succeeded |
Правила
- Финальный статус не откатывается.
paidне станетpending;failedиexpiredне станутpaid. Для повторной попытки создайте новый счёт. - Один платёж на счёт. После
paidстраница оплаты закрыта, повторно заплатить нельзя. - Возврат меняет статус, но не создаёт событие invoice.* — приходит
refund.succeededс объектом возврата, а счёт в нём уже в новом статусе. - pending может длиться от секунд (СБП) до нескольких минут (карта с 3-D Secure). Не показывайте покупателю ошибку по таймауту на своей стороне — дождитесь вебхука или проверьте статус.
- expired выставляется фоновой задачей раз в минуту, так что счёт может прожить до 60 секунд дольше
expiresAt.
Как отражать у себя
| Статус Paydex | Что показать покупателю | Что сделать с заказом |
|---|---|---|
created, pending | «Ожидаем оплату», кнопка «Перейти к оплате» на тот же url | Держать резерв |
paid | «Оплачено» | Выдать товар / активировать услугу |
failed, expired | «Не оплачено», кнопка «Попробовать снова» | Создать новый счёт с новым orderId, снять резерв |
refunded, partially_refunded | «Возврат выполнен» | Отменить заказ полностью или частично |