Обзор примеров интеграции

В данном разделе описаны примеры интеграции с платежным шлюзом HighHelp. Примеры предназначены для ускорения внедрения H2H-интеграции и демонстрируют базовый цикл работы с API:

  • формирование заголовков аутентификации и цифровой подписи;

  • отправку запросов к API;

  • обработку ответов и ошибок.

Общий сценарий первого платежа описан в разделе Быстрый старт. Правила аутентификации и формирования подписи приведены в разделе Аутентификация и подпись.

Состав примеров

В текущей версии доступны следующие примеры:

Каждый пример:

  • использует единый подход к формированию подписи запросов;

  • содержит минимальный рабочий код для выполнения оплаты и проверки статуса;

  • показывает базовую структуру проекта и работу с конфигурацией.

Конкретный набор эндпоинтов и сценариев (создание платежа, получение информации о заявке и т.п.) описан в документации к каждому примеру.

Что иллюстрируют примеры

Примеры иллюстрируют типовой H2H-сценарий:

  • загрузка конфигурации (идентификатор кассы, приватный ключ, базовый URL API);

  • формирование тела запроса на создание платежа;

  • нормализация данных и формирование сообщения для подписи;

  • создание цифровой подписи и установка заголовков x-access-*;

  • отправка HTTP-запроса к API;

  • разбор ответа и базовая обработка ошибок.

Требования к окружению

Перед использованием примеров убедитесь, что:

  • у вас есть доступ к кабинету мерчанта и создана касса;

  • для кассы сгенерирована пара RSA-ключей (public/private);

  • вы можете выполнять запросы к https://api.hh-processing.com из вашего окружения;

  • установлены требуемые версии интерпретатора/движка для выбранного примера (например, PHP или Node.js).

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

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

Рекомендации по использованию

Рекомендуется:

  • сначала настроить тестовое окружение и выполнить базовый сценарий из раздела Быстрый старт;

  • затем развернуть и запустить пример на выбранном языке;

  • адаптировать пример под вашу инфраструктуру:

    • вынести секреты (идентификатор кассы, ключи) в переменные окружения или отдельный конфигурационный файл;

    • доработать обработку ошибок и логирование;

    • реализовать собственную логику хранения и обработки статусов платежей.

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