Статусы платежа
Что значит каждый статус платежа, когда зачислять деньги и почему таймаут не равен отказу.
Статус отвечает на вопрос, чем кончился платёж. Признак 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, о них пишет журнал изменений.