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

Примеры на PHP

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

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

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

Требования

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

  • PHP 8.4.1
  • Composer 2.8.3

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

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

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

composer install

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

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

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

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

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

  • на получение доступного списка банков banks_get.php
  • создание заявки на оплату payment_create.php
  • получение информации по статусу созданной заявки на оплату payment_get_info.php
  • создание заявки на выплату payout_create.php
  • получение информации по статусу созданной заявки на выплату payout_get_info.php

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

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

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

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

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

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

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

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

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

php -S localhost:8000 callback_processor.php

Заметьте, если цифровая подпись корректная, то в stdout будет выведен лог "Signature is valid (via OpenSSL)"