Перед началом работы

В этом разделе перечислены требования и исходные данные, которые необходимо подготовить до начала интеграции с платежным шлюзом HighHelp.

Для кого этот раздел

Раздел предназначен для разработчиков и специалистов, которые:

  • настраивают интеграцию по API (H2H) и/или через виджет;

  • отвечают за конфигурацию касс и окружений;

  • подготавливают инфраструктуру для отправки запросов и приема оповещений.

Необходимые доступы и учетные записи

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

  • Создана учетная запись в личном кабинете мерчанта.

  • Создана хотя бы одна касса для тестового окружения.

  • Для кассы сгенерирована пара RSA-ключей (публичный и приватный).

  • Указаны контактные лица со стороны мерчанта для операционных и технических вопросов.

Порядок создания кассы и генерации ключей описан в разделе Аутентификация и подпись.

Решения по продукту и бизнес-сценариям

До начала разработки необходимо согласовать, какие сценарии будут реализованы в первой итерации интеграции:

  • Типы платежей:

    • входящие платежи (payin);

    • исходящие выплаты (payout).

  • Продукты:

    • P2P-переводы;

    • e-commerce платежи (ECOM).

  • Канал интеграции:

    • H2H-интеграция (сервер—​сервер);

    • интеграция через виджет (платежная страница).

Список типов платежей приведен в разделе Типы платежей.

Выбор методов оплаты и выплат

Для каждого выбранного сценария необходимо согласовать методы, которые будут использоваться в первой очереди:

Дополнительно необходимо определить:

  • валюты, в которых будут выполняться операции (см. Коды валют);

  • страны, в которых будет доступна услуга (см. Коды стран).

Требования к инфраструктуре мерчанта

Инфраструктура мерчанта должна удовлетворять следующим условиям:

  • Бэкенд может инициировать исходящие HTTPS-запросы к https://api.hh-processing.com.

  • Есть публично доступные HTTPS-эндпоинты для приема оповещений.

  • Для эндпоинтов оповещений настроены:

    • поддержка HTTPS;

    • логирование входящих запросов и ответов;

    • обработка повторных оповещений (идемпотентность по project_id:payment_id:status:sub_status).

  • Система логирования позволяет сохранять:

    • тело запросов к API (без чувствительных данных платежных карт);

    • тело ответов и оповещений;

    • значения технических идентификаторов (request_id, payment_id, project_id).

Рекомендуется согласовать требования по белым спискам IP-адресов и сетевым ограничениям с ответственным специалистом HighHelp.

Данные для настройки кассы

До начала интеграции необходимо подготовить данные, которые требуются для настройки кассы и маршрутизации платежей:

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

  • Список URL для оповещений:

    • merchant_callback_url — информативные оповещения по промежуточным статусам;

    • merchant_success_callback_url — оповещения об успешных операциях;

    • merchant_decline_callback_url — оповещения о неуспешных операциях.

  • Список используемых валют и стран.

  • Ограничения и лимиты мерчанта по суммам и количеству операций.

  • Требования к маршрутизации заявок (использование поля extra_param и других дополнительных параметров).

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

Окружения и тестовые данные

Интеграция выполняется поэтапно:

  • на тестовом окружении;

  • после завершения тестирования — на продуктивном окружении.

Для тестового окружения требуется:

  • набор тестовых реквизитов (карты, счета, сценарии статусов);

  • параметры URL и заголовков для запросов;

  • пример оповещений и статусов для основных сценариев.

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

После подготовки описанных выше данных можно переходить к:

  • выполнению минимального сценария интеграции по шагам, описанным в разделе Быстрый старт;

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

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