Обзор платежного виджета (H2C)

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

Подробные определения терминов приведены в разделе Глоссарий. Общие понятия интеграции см. в разделе Основные понятия.

Когда использовать виджет

Виджет целесообразно использовать в следующих случаях:

  • Нет необходимости разрабатывать собственную платежную форму.

  • Требуется сократить объем работы по соответствию требованиям безопасности, так как платежные реквизиты вводятся на стороне HighHelp.

  • Нужна единая форма оплаты для разных стран и платежных методов.

  • Важно быстро запустить прием платежей с минимальными изменениями на фронтенде.

Если требуется полный контроль над интерфейсом и бизнес-логикой, вместо виджета можно использовать H2H-интеграцию. См. раздел Обзор H2H-интеграции.

Поддерживаемые сценарии

Виджет поддерживает два основных типа сценариев:

  • P2P-переводы через виджет.

  • Интернет-платежи (ECOM) через виджет.

P2P через виджет

Виджет позволяет выполнять P2P-переводы (payin) в ряде стран. Для каждой страны есть отдельный раздел с параметрами запросов, примерами и списком поддерживаемых методов.

См. следующие разделы:

Список доступных методов, которые можно указать в поле payment:widget_method, приведен в разделе Методы виджета.

Интернет-платежи (ECOM) через виджет

Подробно сценарий описан в разделе Интернет-платежи через виджет.

Общая схема работы виджета

Ниже приведен общий порядок обработки платежа через виджет. Конкретный набор полей и структура ответов см. в профильных разделах для P2P и ECOM.

  1. Система мерчанта создает заявку через API в режиме H2C.

    • В запросе указываются:

      • идентификатор кассы project_id;

      • параметры платежа (сумма, валюта, тип платежа);

      • метод виджета в поле payment:widget_method;

      • URL-адреса для оповещений merchant_callback_url, merchant_success_callback_url, merchant_decline_callback_url.

    • Аутентификация и подпись выполняются по правилам из раздела Аутентификация и подпись.

  2. HighHelp принимает запрос, выполняет проверки и создает платежную заявку.

    • В ответе возвращаются данные, необходимые для открытия платежной страницы виджета.

    • Структура ответа зависит от сценария и описана в соответствующем разделе P2P или ECOM.

  3. Фронтенд или бэкенд мерчанта открывает платежную страницу виджета для пользователя.

    • Клиент перенаправляется по переданному URL или виджет открывается в отдельном окне вкладке.

    • Вся платежная форма и ввод реквизитов выполняются на стороне HighHelp.

  4. Клиент вводит платежные данные и проходит необходимые проверки.

    • Для части операций может выполняться дополнительная аутентификация (например, 3-D Secure).

    • При необходимости используются дополнительные редиректы, описанные в профильных разделах.

  5. HighHelp завершает обработку заявки и обновляет ее статус.

    • Статусы и коды ошибок описаны в разделе Коды статусов.

    • Информация о платеже доступна через API и в кабинете мерчанта.

  6. Система мерчанта получает оповещение о результате.

    • Типы оповещений и структура тела зависят от сценария (P2P или ECOM).

    • Рекомендуется реализовать проверку цифровой подписи и защиту от повторной обработки дубликатов.

Требования и зависимости

Для корректной работы виджета необходимо:

  • Использовать HTTPS для всех URL, передаваемых в merchant_callback_url, merchant_success_callback_url, merchant_decline_callback_url.

  • Настроить аутентификацию запросов к API согласно разделу Аутентификация и подпись.

  • Учитывать список поддерживаемых стран и языков:

  • Передавать суммы в дробных единицах валюты согласно правилам из Коды валют.

Следующие шаги

Для реализации интеграции через виджет последовательно изучите: