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

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

Выплаты средств пользователям могут быть отклонены по разным причинам. Это может быть связано, например, с достижением суточного лимита на сумму выплат, заданного на стороне платёжной системы, или недоступностью сервисов платёжной системы (провайдера). И в подобных случаях может быть актуальна возможность повторных попыток выполнения выплат в рамках того же платежа, которая поддерживается в платёжной платформе 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.