PHPackages assist/assist\_ru\_php\_core - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. assist/assist\_ru\_php\_core ActiveLibrary[Utility & Helpers](/categories/utility) assist/assist\_ru\_php\_core ============================ 1.0.0(1y ago)1361[27 issues](https://github.com/assist-group/assist-ru-php-core/issues)[1 PRs](https://github.com/assist-group/assist-ru-php-core/pulls)MITPHPPHP ~8.1.0 Since Aug 2Pushed 1y ago2 watchersCompare [ Source](https://github.com/assist-group/assist-ru-php-core)[ Packagist](https://packagist.org/packages/assist/assist_ru_php_core)[ RSS](/packages/assist-assist-ru-php-core/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (6)Versions (2)Used By (0) Assist.ru ========= [](#assistru) PHP библиотека для работы с платежным интегратором Assist.ru Содержание ---------- [](#содержание) - [Установка](#%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0) - [Использование](#%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5) - [Создание запроса](#%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%B0) - [Получение данных ответа](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0) - [Подпись и Проверочное значение](#%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D1%8C-%D0%B8-%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%BE%D1%87%D0%BD%D0%BE%D0%B5-%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5) - [Подпись(Signature)](#%D0%BF%D0%BE%D0%B4%D0%BF%D0%B8%D1%81%D1%8C-signature) - [Проверочное значение(Checkvalue)](#%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D1%80%D0%BE%D1%87%D0%BD%D0%BE%D0%B5-%D0%B7%D0%BD%D0%B0%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-checkvalue) - [Конфигурация](#%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8F) - [Базовая конфигурация SDK клиента](#%D0%B1%D0%B0%D0%B7%D0%BE%D0%B2%D0%B0%D1%8F-%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8F-sdk-%D0%BA%D0%BB%D0%B8%D0%B5%D0%BD%D1%82%D0%B0) - [Конфигурация запросов](#%D0%BA%D0%BE%D0%BD%D1%84%D0%B8%D0%B3%D1%83%D1%80%D0%B0%D1%86%D0%B8%D1%8F-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2) - [Обычный платёж (CreatePaymentRequest)](#%D0%BE%D0%B1%D1%8B%D1%87%D0%BD%D1%8B%D0%B9-%D0%BF%D0%BB%D0%B0%D1%82%D1%91%D0%B6-assistrequestcreatepaymentcreatepaymentrequest) - [Подтверждение платежа (ChargeRequest)](#%D0%BF%D0%BE%D0%B4%D1%82%D0%B2%D0%B5%D1%80%D0%B6%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%B0-assistrequestcreatepaymentchargerequest) - [Рекуррентный платёж (RecurrentPaymentRequest)](#%D1%80%D0%B5%D0%BA%D1%83%D1%80%D1%80%D0%B5%D0%BD%D1%82%D0%BD%D1%8B%D0%B9-%D0%BF%D0%BB%D0%B0%D1%82%D1%91%D0%B6-assistrequestrecurrentpaymentrecurrentpaymentrequest) - [Отмена платежа (CancelRequest)](#%D0%BE%D1%82%D0%BC%D0%B5%D0%BD%D0%B0-%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%B0-assistrequestcreatepaymentcancelrequest) - [Получение результата (OrderResultRequest)](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%80%D0%B5%D0%B7%D1%83%D0%BB%D1%8C%D1%82%D0%B0%D1%82%D0%B0-assistrequestorderresultorderresultrequest) - [Получение статуса заказа (OrderStateRequest)](#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D1%82%D0%B0%D1%82%D1%83%D1%81%D0%B0-%D0%B7%D0%B0%D0%BA%D0%B0%D0%B7%D0%B0-assistrequestorderresultorderstaterequest) - [Обработка ответов с ошибками](#%D0%BE%D0%B1%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%BA%D0%B0-http-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%BE%D0%B2-%D1%81%D0%BE%D0%B4%D0%B5%D1%80%D0%B6%D0%B0%D1%89%D0%B8%D1%85-%D0%BE%D1%88%D0%B8%D0%B1%D0%BA%D0%B8) - [Тестирование](#%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5) Установка --------- [](#установка) ``` $ composer require assist/assist_ru_php_core ``` Использование ------------- [](#использование) ### Создание запроса [](#создание-запроса) Подготовьте конфигурацию клиента ``` $config = new \Assist\Config\Config([ //ID предприятия 'shop_id' => 999999, //Логин аккаунта предприятия 'login' => 'login', //Пароль аккаунта предприятия 'password' => 'password', ]); ``` Создайте экземпляр класса клиента и передайте конфигурацию ``` $client = new \Assist\Client($config); ``` Создайте экземпляр класс запроса и передайте параметры запроса ``` $createPayment = new \Assist\Request\CreatePayment\CreatePaymentRequest([ 'OrderNumber' => 'number', 'OrderAmount' => 'amount', 'ChequeItems' => '', ]); ``` Вызовете метод запроса и передайте в него инстанс запроса ``` $response = $client->createPayment($createPayment); ``` ### Получение данных ответа [](#получение-данных-ответа) Все классы ответов имеют метод getResponseData(), который возвращает массив с данными ответа ``` $responseData = $response->getResponseData(); ``` Структура массива соответствует структуре JSON ответа API Ассист Так-же для каждого параметра доступны соответствующие геттеры ``` $response = $client->createPayment($createPaymentRequest); $paymentUrl = $response->getUrl(); $orderState = $response->getOrderState(); $expirationTime = $response->getExpirationTime(); ``` ### Подпись и Проверочное значение [](#подпись-и-проверочное-значение) Для формирования Подписи (Signature) и Проверочного значения (Checkvalue) предоставляется хелпер Assist\\Helpers\\SignHelper. #### Подпись (Signature) [](#подпись-signature) Для формирования подписи (Signature) в Assist\\Helpers\\SignHelper предусмотрен метод getSignature(array $params, string $privateKey); Метод принимает два параметра: массив $params включающий параметры для формирования подписи и строку $privateKey. Обязательные параметры: - Merchant\_ID - OrderNumber - OrderAmount - OrderCurrency Необязательные параметры: - OrderMaxPoints - CustomerNumber - Disable3DS - Prepayment Параметры в массиве $params передаются в формате ключ => значение. #### Проверочное значение (Checkvalue) [](#проверочное-значение-checkvalue) Для формирования проверочного значения (Checkvalue) в Assist\\Helpers\\SignHelper предусмотрен метод getCheckValue(array $params, string $salt); Метод принимает два параметра: массив $params включающий параметры для формирования подписи и секретное слово $salt. Обязательные параметры: - Merchant\_ID - OrderNumber - OrderAmount - OrderCurrency Необязательные параметры: - OrderMaxPoints - CustomerNumber - Disable3DS - Prepayment Параметры в массиве $params передаются в формате ключ => значение. Конфигурация ------------ [](#конфигурация) ### Базовая конфигурация SDK клиента [](#базовая-конфигурация-sdk-клиента) Список доступных параметров для класса Config Имя параметраОписаниеЗначение по умолчаниюapi\_urlосновной URL API Ассистtest\_api\_urlТестовый URL API Ассистtest\_modeИндикатор тестового режимаfalselangЯзык авторизационных страницRUmerchant\_idID предприятия-loginЛогин предприятия-passwordПароль предприятия-### Конфигурация запросов [](#конфигурация-запросов) Пример конфигурации ``` $config = [ 'Merchant_ID' => 'string', 'OrderNumber' => 'string', 'OrderAmount' => 0, 'ChequeItems' => [ [ "id" => "string", "product" => "string", "name" => "string", "price" => 0, "amount" => 0, "quantity" => 0, "tax" => "string", "еancode" => "string", "uncode" => "string", "gs1code" => "string", "furcode" => "string", "egaiscode" => "string", "hscode" => "string", "subjtype" => 0 ] ] ]; $createPaymentRequest = new \Assist\Request\CreatePayment\CreatePaymentRequest($config); ``` #### Обычный платёж (Assist\\Request\\CreatePayment\\CreatePaymentRequest) [](#обычный-платёж-assistrequestcreatepaymentcreatepaymentrequest) Конфигурация соответствует параметрам запроса **/pay/payrequest.cfm** [Документация "/pay/payrequest.cfm"](https://docs.assist.ru/pages/viewpage.action?pageId=5767488) #### Подтверждение платежа (Assist\\Request\\CreatePayment\\ChargeRequest) [](#подтверждение-платежа-assistrequestcreatepaymentchargerequest) Конфигурация соответствует параметрам запроса **/charge/charge.cfm** [Документация "/charge/charge.cfm"](https://docs.assist.ru/pages/viewpage.action?pageId=5767493) #### Рекуррентный платёж (Assist\\Request\\RecurrentPayment\\RecurrentPaymentRequest) [](#рекуррентный-платёж-assistrequestrecurrentpaymentrecurrentpaymentrequest) Конфигурация соответствует параметрам запроса **/recurrent/rp.cfm** [Документация "/recurrent/rp.cfm"](https://docs.assist.ru/pages/viewpage.action?pageId=17368407) #### Отмена платежа (Assist\\Request\\CreatePayment\\CancelRequest) [](#отмена-платежа-assistrequestcreatepaymentcancelrequest) Конфигурация соответствует параметрам запроса **/cancel/wscancel.cfm** [Документация "/cancel/wscancel.cfm"](https://docs.assist.ru/pages/viewpage.action?pageId=17368389) #### Получение результата (Assist\\Request\\OrderResult\\OrderResultRequest) [](#получение-результата-assistrequestorderresultorderresultrequest) Конфигурация соответствует параметрам запроса **/orderresult/orderresult.cfm** [Документация "/orderresult/orderresult.cfm"](https://docs.assist.ru/pages/viewpage.action?pageId=5767463) #### Получение статуса заказа (Assist\\Request\\OrderState\\OrderStateRequest) [](#получение-статуса-заказа-assistrequestorderstateorderstaterequest) Конфигурация соответствует параметрам запроса **/orderstate/orderstate.cfm** [Документация "/orderstate/orderstate.cfm"](https://docs.assist.ru/pages/viewpage.action?pageId=5767492) Обработка http ответов содержащих ошибки ---------------------------------------- [](#обработка-http-ответов-содержащих-ошибки) Коды HTTP ответов отличные от кода 200 обрабатываются handlerError(), который выбрасывает соответствующее коду ответа исключение. Исключение унаследованные от класса Assist\\Exceptions\\HttpException имеют методы getResponseHeaders() и getResponseBody(). Тестирование ------------ [](#тестирование) Для тестирования SDK в проекте применяется библиотека pest Запуск тестирования ``` $ ./vendor/bin/pest ``` ### Health Score 23 — LowBetter than 27% of packages Maintenance16 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community9 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 645d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d37fb17548f9e8fa7ac439d694bf546487d993e79ccbba965410e027b78d74dc?d=identicon)[assist](/maintainers/assist) --- Top Contributors [![mihan007](https://avatars.githubusercontent.com/u/939122?v=4)](https://github.com/mihan007 "mihan007 (1 commits)") ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/assist-assist-ru-php-core/health.svg) ``` [![Health](https://phpackages.com/badges/assist-assist-ru-php-core/health.svg)](https://phpackages.com/packages/assist-assist-ru-php-core) ``` ### Alternatives [grumpydictator/firefly-iii Firefly III: a personal finances manager. 22.8k69.3k](/packages/grumpydictator-firefly-iii)[civicrm/civicrm-core Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 728272.9k17](/packages/civicrm-civicrm-core)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 255.2k](/packages/aedart-athenaeum)[ralphjsmit/laravel-helpers A package containing handy helpers for your Laravel-application. 13704.6k2](/packages/ralphjsmit-laravel-helpers) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)