Статусы платежа

Что значит каждый статус платежа, когда зачислять деньги и почему таймаут не равен отказу.

Статус отвечает на вопрос, чем кончился платёж. Признак inReview отвечает на второй вопрос: решается ли исход ещё на нашей стороне. Читать нужно оба.

Статусы

СтатусЧто значитЧто делать кассеФинальный
CREATEDПлатёж создан, к провайдеру ещё не ушёл.Ждать; при fieldsOnPage отправить плательщика по action.нет
PROCESSINGПлатёж у провайдера, исход ещё неизвестен.Ждать: деньги могли пройти.нет
AWAITING_CUSTOMERЖдём плательщика.Отправить плательщика по action.нет
SUCCEEDEDОплачен.Зачислить paidMinor, когда inReview равно false.да
PARTIALLY_PAIDПришло меньше запрошенного.Не зачислять: платёж разбирает наша сторона.да
OVERPAIDПришло больше запрошенного.Не зачислять: платёж разбирает наша сторона.да
FAILEDОтказ, денег нет.Можно предложить заплатить снова.да
CANCELLEDПлатёж отменён. Отмены через API нет, у платежа из API этот статус не наступает.Не зачислять.да
EXPIREDСрок оплаты вышел.Не звать платить снова: поздние деньги.да
REJECTEDОтклонён у нас до провайдера, попытки не было: блокировка клиента, антифрод или правило маршрутизации. Причина в reason.Не зачислять.да

Из SUCCEEDED, FAILED и REJECTED платёж не выходит никогда.

Когда зачислять

Таймаут не равен отказу

Если провайдер не ответил или ответил так, что исход не понять, платёж остаётся PROCESSING с inReview: true. Это не отказ: деньги могли пройти. Мы сами спрашиваем провайдера об исходе, а если не знает и он, исход называет человек на нашей стороне.

Пока исход неизвестен, не зачисляйте деньги и не предлагайте плательщику заплатить снова: если первый платёж прошёл, второй спишет деньги ещё раз.

Поздние деньги

EXPIRED значит, что к сроку expiresAt провайдер оплату не подтвердил. Если он подтвердит её позже, платёж перейдёт в SUCCEEDED, а при расхождении суммы в PARTIALLY_PAID или OVERPAID. Поэтому плательщику с истёкшим платежом, который уже отправил деньги, платить снова не нужно. Истёкшие платежи касса перечитывает сверкой: уведомление о поздних деньгах может не дойти.

Разбор на нашей стороне

inReview: true значит, что исход ещё решается на нашей стороне, доспросом провайдера или человеком: исход неизвестен, сумма не сошлась, провайдер назвал деньги в другой валюте или прислал спорный отчёт уже после успеха. Зачислять по такому платежу нельзя, даже при SUCCEEDED.

Разбор снимает окончательный ответ провайдера. Если такого ответа нет, платёж остаётся в разборе, пока его не решит человек на нашей стороне. У PARTIALLY_PAID и OVERPAID разбор не снимается: о деньгах решает наша сторона, опрашивать такой платёж дальше незачем.

Причина статуса

reason называет причину отказа, отклонения, истечения или отмены и равен null, когда называть нечего.

КодЧто случилось
declined_by_bankБанк плательщика отклонил операцию.
declined_by_providerПровайдер отклонил операцию.
insufficient_fundsНедостаточно средств.
issuer_limit_exceededПревышен лимит банка по карте.
card_expiredСрок действия карты истёк.
invalid_card_dataНеверные данные карты.
fraud_suspectedОперация отклонена как подозрительная.
3ds_failedПлательщик не прошёл проверку 3-D Secure.
3ds_abandonedПлательщик не завершил проверку 3-D Secure.
3ds_rejectedБанк отклонил операцию на проверке 3-D Secure.
method_not_enabledСпособ оплаты не подключён мерчанту.
attempts_exhaustedРазрешённые попытки провести платёж закончились.
request_expiredСрок оплаты вышел.
abandoned_by_customerПлательщик не завершил оплату.
technical_failureТехнический сбой у провайдера или у нас.
not_availableСпособ оплаты сейчас недоступен.
customer_blockedКлиент заблокирован.
firewall_blockedОтклонено антифродом.
rule_declinedОтклонено правилом маршрутизации.

Незнакомый код обрабатывайте по статусу: новые причины добавляются без смены версии API, о них пишет журнал изменений.

API v1 · собрано 18.11.2026 · выпуск f13e6bf

Справочник методов собирается из кода сервера: он не описывает адрес, которого нет.