Повторные попытки выплат
Общая информация
Выплаты средств пользователям могут быть отклонены по разным причинам. Это может быть связано, например, с достижением суточного лимита на сумму выплат, заданного на стороне платёжной системы, или недоступностью сервисов платёжной системы (провайдера). И в подобных случаях может быть актуальна возможность повторных попыток выполнения выплат в рамках того же платежа, которая поддерживается в платёжной платформе ecommpay.
Такая возможность поддерживается для всех платёжных методов: как с использованием платёжных карт, так и с использованием других платёжных инструментов. При этом повторные попытки могут инициироваться платёжной платформой автоматически, до успешного выполнения выплаты или исчерпания заданного количества таких попыток, либо специалистами технической поддержки вручную.
Особенности и ограничения
При использовании возможности повторных попыток проведения выплат необходимо учитывать следующее:
-
Повторные попытки доступны только для выплат, инициированных уже после подключения этой возможности в проекте.
Выполнить повторную попытку для выплат, инициированных до подключения этой возможности, нельзя ни автоматически, ни вручную; для проведения платежа в этом случае необходимо его вновь инициировать, указав при этом новый идентификатор платежа (
payment_id
). -
К причинам отказа, при которых поддерживается возможность проведения повторных попыток, на данный момент относятся следующие:
- Недоступность платёжной системы (провайдера) или истечение срока ожидания ответа. Коды ответов:
314
,601
,10505
,10602
,20202
и20602
. - Достижение суточного лимита на сумму или частоту платежей. Коды ответов:
3317
–3319
,3320
–3322
,3335
,3336
–3340
,3450
и20101
. - Отказ платёжной системы (провайдера) в проведении выплаты без объяснения причин. Коды ответов:
10000
,10100
,20000
и20100
.
Актуальную информацию о причинах отказа, при которых поддерживается возможность проведения повторных попыток, можно получить у курирующего менеджера ecommpay либо специалистов технической поддержки (support@ecommpay.com), а подробную информацию о перечисленных кодах — в разделе Информация об операциях.
- Недоступность платёжной системы (провайдера) или истечение срока ожидания ответа. Коды ответов:
- Фактическое время, через которое выполняется каждая последующая попытка, может незначительно отличаться от заданного.
Подключение и настройка
Чтобы подключить эту возможность, со стороны мерчанта необходимо согласовать с курирующим менеджером ecommpay её подключение, а затем обратиться к специалистам технической поддержки (support@ecommpay.com).
Стандартные значения количества попыток и периода между их выполнением при их автоматическом инициировании — 12 попыток с периодом, равным одному часу. Однако при необходимости эти значения можно изменить с учётом допустимых диапазонов, информацию о которых можно уточнить у специалистов технической поддержки.
Порядок выполнения
Проведение выплат при использовании этой возможности инициируются стандартно: от веб-сервиса к платёжной платформе направляется запрос на выплату через Gate, который затем обрабатывается и направляется к сервису платёжной системы (провайдера). При успешном завершении выплаты от платёжной платформы к веб-сервису отправляется оповещение с итоговым статусом платежа — success
, а при получении отказа на стороне платёжной платформы определяется возможность выполнения повторной попытки с учётом полученного кода причины отказа и, если такая возможность доступна, к веб-сервису отправляется оповещение со статусом платежа awaiting retry
. Если нет, оповещение отправляется с итоговым статусом decline
.
Статус платежа awaiting retry
сохраняется в период между выполнением попыток и вновь присваивается платежу, если очередная попытка отклонена, а количество доступных попыток при этом не исчерпано. При исчерпании количества доступных попыток платёж отклоняется с итоговым статусом decline
.
Вне зависимости от способа инициирования повторных попыток, автоматически или вручную, информирование мерчанта о каждой попытке не выполняется. Оповещение от платёжной платформы к веб-сервису мерчанта направляется только при получении платежом итогового статуса (success
или decline
), а в интерфейсе Dashboard отображается информация только о тех попытках, которые изменили статус платежа на итоговый. Уточнить информацию о платеже до присвоения ему итогового статуса можно через ответ на запрос о состоянии платежа (подробнее).
Дополнительные материалы
При работе с повторными попытками проведения выплат могут быть полезны следующие материалы:
- Модель проведения платежей — раздел с общей информацией о типах поддерживаемых платежей и операций, а также об их возможных статусах.
- Выплаты — раздел с подробной информацией о проведении выплат с прямым использованием платёжных карт.
- Методы — раздел с подробной информацией о проведении выплат с использованием различных платёжных методов.
- Оповещения — раздел с информацией об оповещениях и работе с ними.
- Информация об операциях — раздел с информацией о кодах ошибок, используемых в платёжной платформе.
- Контроль и проведение платежей — раздел с информацией о проведении платежей и операций через Dashboard.