lapaygroup/start2pay

Start 2 Pay PHP SDK

Start 2 Pay

PHP SDK для интеграции с сервисом https://start2pay.com
Описание API Start 2 Pay https://wiki.start2pay.com, _(*1)

Установка

Для установки можно использовать менеджер пакетов Composer, _(*2)

composer require lapaygroup/start2pay

Файл конфигурации

Для работы SDK нужно разместить конфигурационный yaml файл. Пример можно посмотреть тут., _(*3)

Описание параметров: - auth - host - адрес API - username - логин - password - пароль - salt - соль для создания контекста - callback_salt - соль для подписи callbacks - display_options - language - язык платежной страницы - iframe - флаг использования iframe вместо переадресации на платежную страницу Start 2 Pay - close_additional_tabs: - флаг закрытия всех дополнительных вкладок - device - тип устройства (desktop, mobile) - theme - цветовая схема платежной страницы (layout2_white, layout2_black, layout2_dark, layout2_violet) - message - Сообщение для заказчика. Such rules, limits, etc - description - Описание отображаемое на платежной странице. - disable_payment_currency - Данный параметр позволяет при переданом значении true отображать на форме оплаты только одну указанную валюту (currency) которая использовалась при создании платежного контекста - available_payment_systems - массивы с алиасами платежных направлений ввода и вывода, которые будут доступны для выбора на платежной странице., _(*4)

Использование SDK

Для получения платежного контекста (ссылки на платежную страницу или iframe) нужно использовтаь метод getContext., _(*5)

Пример получения ссылки, _(*6)

$payInfo['currency'] = 'RUB';
$payInfo['amount'] = '150.00';
$payInfo['invoice'] = '100';
$payInfo['user_id'] = '123456';
$payInfo['selected_payment_system'] = 'bank_cards';

try {
    $API = new \LapayGroup\Start2Pay\API('path/to/config.yml');
    $context = $API->getContext($payInfo);

    if (! empty($context['payment_url']) {
        header('Location: '.$context['payment_url']);
    } else {
        // Обработка ошибки получения платежного контекста
    }
}

catch(\Exception $e) {
    // Обработка ошибки обмена с Start 2 Pay
}

При получении callback запросов на проверку и проведение оплаты от Start 2 Pay также нужно проверять подпись в параметре signature в JSON массиве данных. Для проверки подписи нужно использовать метод validCallbackSignature. На вход принимает JSON текст из запроса., _(*7)

Пример проверки подписи, _(*8)

try {
    $API = new \LapayGroup\Start2Pay\API('path/to/config.yml');
    $valid = $API->validCallbackSignature($json);

    if ($valid) {
        // Подпись верна - обрабатываем callback
    } else {
        // Обрабатываем ошибку подписи
    }
}

catch(\Exception $e) {
    // Обработка ошибки обмена с Start 2 Pay
}