Повторные попытки выплат

Общая информация

Выплаты средств пользователям могут быть отклонены по разным причинам. Это может быть связано, например с достижением суточного лимита на сумму выплат, заданного на стороне платежной системы, или недоступностью сервисов платежной системы (провайдера). И в подобных случаях может быть актуальна возможность повторных попыток выполнения выплат в рамках того же платежа, которая поддерживается в платежной платформе Rocketpay.

Особенности и ограничения

При использовании возможности повторных попыток проведения выплат необходимо учитывать следующее:

  • Повторные попытки доступны только для выплат, инициированных уже после подключения этой возможности в проекте.

    Выполнить повторную попытку для выплат, инициированных до подключения этой возможности, нельзя ни автоматически, ни вручную; для проведения платежа в этом случае необходимо его вновь инициировать, указав при этом новый идентификатор платежа (payment_id).

  • К причинам отказа, при которых поддерживается возможность проведения повторных попыток, на данный момент относятся следующие:

    • Недоступность платежной системы (провайдера) или истечение срока ожидания ответа. Коды ответов: 314, 601, 10505, 10602, 20202 и 20602.
    • Достижение суточного лимита на сумму или частоту платежей. Коды ответов: 3317–3319, 3320–3322, 3335, 3336–3340, 3450 и 20101.
    • Отказ платежной системы (провайдера) в проведении выплаты без объяснения причин. Коды ответов: 10000, 10100, 20000 и 20100.

    Актуальную информацию о причинах отказа, при которых поддерживается возможность проведения повторных попыток, можно получить у курирующего менеджера Rocketpay либо специалистов технической поддержки (support@rocketpay.kz), а подробную информацию о перечисленных кодах — в разделе Статусы операций и коды ответов.

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

Подключение и настройка

Чтобы подключить эту возможность, со стороны мерчанта необходимо согласовать с курирующим менеджером Rocketpay ее подключение, а затем обратиться к специалистам технической поддержки (support@rocketpay.kz).

Стандартные значения количества попыток и периода между их выполнением при их автоматическом инициировании — 12 попыток с периодом, равным одному часу. Однако при необходимости эти значения можно изменить с учетом допустимых диапазонов, информацию о которых можно уточнить у специалистов технической поддержки.

Порядок выполнения

Проведение выплат при использовании этой возможности инициируются стандартно: от веб-сервиса к платежной платформе направляется запрос на выплату через Gate, который затем обрабатывается и направляется к сервису платежной системы (провайдера). При успешном завершении выплаты от платежной платформы к веб-сервису отправляется оповещение с итоговым статусом платежа — success, а при получении отказа на стороне платежной платформы определяется возможность выполнения повторной попытки с учетом полученного кода причины отказа и, если такая возможность доступна, к веб-сервису отправляется оповещение со статусом платежа awaiting retry. Если нет, оповещение отправляется с итоговым статусом decline.

Статус платежа awaiting retry сохраняется в период между выполнением попыток и вновь присваивается платежу, если очередная попытка отклонена, а количество доступных попыток при этом не исчерпано. При исчерпании количества доступных попыток платеж отклоняется с итоговым статусом decline.

Вне зависимости от способа инициирования повторных попыток, автоматически или вручную, информирование мерчанта о каждой попытке не выполняется. Оповещение от платежной платформы к веб-сервису мерчанта направляется только при получении платежом итогового статуса (success или decline), а в интерфейсе Dashboard отображается информация только о тех попытках, которые изменили статус платежа на итоговый. Уточнить информацию о платеже до присвоения ему итогового статуса можно через ответ на запрос о состоянии платежа (подробнее).

Дополнительные материалы

При работе с повторными попытками проведения выплат могут быть полезны следующие материалы: