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

Примеры на JS

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

Скачать примеры кода

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

Требования

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

  • Node.js 18+
  • npm 9+

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

Установка зависимостей

Установите зависимости с помощью npm, выполнив команду в текущей директории:

npm install

Отправка запросов в API

Получение приватного ключа

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

Запуск примеров кода

В качестве примеров реализованы скрипты:

  • Получение списка банков: banks_get.js
  • Создание заявки на оплату: payment_create.js
  • Получение информации по платежу: payment_get_info.js
  • Создание заявки на выплату: payout_create.js
  • Получение информации по выплате: payout_get_info.js

Перед тем как запустить примеры, вам необходимо заполнить конфигурационный файл config.js:

  1. projectId - ID вашей кассы, который можно найти на дашборде: Вкладка "Кассы" → Колонка "ID"
  2. callbackUrl - Домен вашего магазина для получения колбэков.

Запустить примеры можно с помощью команды:

node banks_get.js
или 
node payment_create.js

Обработка колбэков

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

Получение публичного ключа

Публичный ключ для валидации цифровой подписи можно получить в настройках кассы: "API" → "Настройки Callback".
В открывшемся модальном окне найдите блок "Public Key" и нажмите на значок скачивания.
Переименуйте скачанный файл в public_key_for_callbacks.pem и положите его в текущую директорию.

Запуск сервиса обработки колбэков

В качестве примера кода реализован скрипт callback_processor.js, в котором запускается веб-сервис на 8000 порту.
В веб-сервисе реализован обработчик /callback/{status} для получения колбэков.
В этом обработчике реализована логика проверки цифровой подписи, которую можно проверить, запустив скрипт.

Запустить скрипт можно командой:

node callback_processor.js

Если цифровая подпись корректная, то в stdout будет выведен лог "Signature is valid"