PHPackages                             sushi-market/laravel-uds-sdk - 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. [API Development](/categories/api)
4. /
5. sushi-market/laravel-uds-sdk

ActiveLibrary[API Development](/categories/api)

sushi-market/laravel-uds-sdk
============================

Laravel SDK for working with the uds.app service API

v1.3.6(6mo ago)33.6k↓48.9%1MITPHPPHP ^8.2CI passing

Since Oct 24Pushed 6mo ago2 watchersCompare

[ Source](https://github.com/sushi-market/laravel-uds-sdk)[ Packagist](https://packagist.org/packages/sushi-market/laravel-uds-sdk)[ RSS](/packages/sushi-market-laravel-uds-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (15)Used By (0)

*UDS Laravel Package* - PHP SDK [Laravel](https://github.com/laravel/laravel) пакет для взаимодействия с API [uds.app](https://uds.app) от [sushi-market](https://sushi-market.com/)

 [![Build Status](https://github.com/sushi-market/laravel-uds-sdk/actions/workflows/test.yml/badge.svg)](https://github.com/sushi-market/laravel-uds-sdk/actions) [![Latest Version](https://camo.githubusercontent.com/d7d3e6a1a7f330028826f5488375b31cf04cc55e3e810c18914d3a5341462915/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f73757368692d6d61726b65742f6c61726176656c2d7564732d73646b2e7376673f7374796c653d666c61742d737175617265)](https://github.com/sushi-market/laravel-uds-sdk/releases) [![Total Downloads](https://camo.githubusercontent.com/b844a7ec3a144e9c531cfec692a8ab812501127bdfd09c591eceb4851b1f71ff/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73757368692d6d61726b65742f6c61726176656c2d7564732d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sushi-market/laravel-uds-sdk) [![Software License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://github.com/sushi-market/laravel-uds-sdk/blob/master/LICENSE)

Требования
----------

[](#требования)

- PHP 8.2
- Laravel 10.0 - 12.0

Установка
---------

[](#установка)

Вы можете установить пакет через composer:

```
composer require sushi-market/laravel-uds-sdk
```

Немного о UDS
-------------

[](#немного-о-uds)

SDK использует api.uds.app/partner/v2 Всю информацию по ответам и параметрам можно найти в [документации UDS](https://docs.uds.app)

Методы
------

[](#методы)

- **Настройки**
    - [Получение настроек компании](https://github.com/sushi-market/laravel-uds-sdk#%D0%BF%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B5%D0%BA-%D0%BA%D0%BE%D0%BC%D0%BF%D0%B0%D0%BD%D0%B8%D0%B8)
- **Операции**
    - [Рассчитать информацию по операции](https://github.com/sushi-market/laravel-uds-sdk#%D1%80%D0%B0%D1%81%D1%81%D1%87%D0%B8%D1%82%D0%B0%D1%82%D1%8C-%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D1%8E-%D0%BF%D0%BE-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B8-uds-%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F)
    - [Проведение операции](https://github.com/sushi-market/laravel-uds-sdk#%D0%BF%D1%80%D0%BE%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B8-uds-%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F)
    - [Операция возврата](https://github.com/sushi-market/laravel-uds-sdk#%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D1%8F-%D0%B2%D0%BE%D0%B7%D0%B2%D1%80%D0%B0%D1%82%D0%B0-uds-%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D1%8F)

Настройки
---------

[](#настройки)

### Получение настроек компании

[](#получение-настроек-компании)

`getSettings` - Получение настроек компании, способа предоставления скидки и промокода для вступления в компанию. Способ предоставления скидки настраивается в UDS.

Операции
--------

[](#операции)

### Рассчитать информацию по операции \[[UDS документация](https://docs.uds.app/#tag/Operations/paths/~1operations~1calc/post)\]

[](#рассчитать-информацию-по-операции-uds-документация)

`calculateTransaction` - Информация о доступных бонусных баллах для списания или размере скидки (в зависимости от настроек бонусной программы), сумме к оплате после применения скидок / бонусов и о количестве бонусных баллов, которые будут начислены после выполнения операции. Параметры функции:

- array $receipt - Информация о чеке. Ключи соответствуют документации UDS
- string $code - Платёжный код
- array $participant - Информация о клиенте. Должен содержать идентификатор клиента в UDS или номер телефона

`calculateTransactionByCode` - Информация о доступных бонусных баллах по **платёжному коду** для списания или размере скидки (в зависимости от настроек бонусной программы), сумме к оплате после применения скидок / бонусов и о количестве бонусных баллов, которые будут начислены после выполнения операции. Параметры функции:

- string $code - Платёжный код
- array $receipt - Информация о чеке. Ключи соответствуют документации UDS

`calculateTransactionByPhone` - Информация о доступных бонусных баллах по **номеру телефона** для списания или размере скидки (в зависимости от настроек бонусной программы), сумме к оплате после применения скидок / бонусов и о количестве бонусных баллов, которые будут начислены после выполнения операции. Параметры функции:

- string $phone - Номер телефона клиента
- array $receipt - Информация о чеке. Ключи соответствуют документации UDS

`calculateTransactionByUid` - Информация о доступных бонусных баллах по **идентификатору клиента** для списания или размере скидки (в зависимости от настроек бонусной программы), сумме к оплате после применения скидок / бонусов и о количестве бонусных баллов, которые будут начислены после выполнения операции. Параметры функции:

- string $uid - Идентификатор клиента
- array $receipt - Информация о чеке. Ключи соответствуют документации UDS

### Проведение операции \[[UDS документация](https://docs.uds.app/#tag/Operations/paths/~1operations/post)\]

[](#проведение-операции-uds-документация)

`createTransaction` - Проведение операции в UDS. После успешного завершения операция отобразится в списке операций в UDS, а администратор и клиент получат push-уведомление о покупке. Параметры функции:

- array $receipt - Информация о чеке. Ключи соответствуют документации UDS
- ExternalCashier $cashier - Информация о сотруднике. (externalId, name)
- array $tags - Массив идентификаторов тегов, назначаемых клиенту при проведении операции
- Nonce $nonce - Уникальный идентификатор операции. Генерируется автоматически при создании экземпляра класса
- string $code - Платёжный код
- array $participant - Информация о клиенте. Должен содержать идентификатор клиента в UDS или номер телефона

`createTransactionByCode` - Проведение операции в UDS по **платёжному коду**Параметры функции:

- string $code - Платёжный код
- array $receipt - Информация о чеке. Ключи соответствуют документации UDS
- ExternalCashier $cashier - Информация о сотруднике. (externalId, name)
- array $tags - Массив идентификаторов тегов, назначаемых клиенту при проведении операции
- Nonce $nonce - Уникальный идентификатор операции. Генерируется автоматически при создании экземпляра класса

`createTransactionByPhone` - Проведение операции в UDS по **номеру телефона**Параметры функции:

- string $phone - Номер телефона клиента
- array $receipt - Информация о чеке. Ключи соответствуют документации UDS
- ExternalCashier $cashier - Информация о сотруднике. (externalId, name)
- array $tags - Массив идентификаторов тегов, назначаемых клиенту при проведении операции
- Nonce $nonce - Уникальный идентификатор операции. Генерируется автоматически при создании экземпляра класса

`createTransactionByUid` - Проведение операции в UDS по **идентификатору клиента**Параметры функции:

- string $uid - Идентификатор клиента
- array $receipt - Информация о чеке. Ключи соответствуют документации UDS
- ExternalCashier $cashier - Информация о сотруднике. (externalId, name)
- array $tags - Массив идентификаторов тегов, назначаемых клиенту при проведении операции
- Nonce $nonce - Уникальный идентификатор операции. Генерируется автоматически при создании экземпляра класса

### Операция возврата \[[UDS документация](https://docs.uds.app/#tag/Operations/paths/~1operations~1%7Bid%7D~1refund/post)\]

[](#операция-возврата-uds-документация)

`refundTransaction` - Возврат операции по ее идентификатору. Если указан параметр partialAmount, то возврат будет частичным, иначе - полным Параметры функции:

- int $id - Идентификатор возвращаемой операции
- float $partialAmount - сумма возврата

Хелпер-функции
--------------

[](#хелпер-функции)

`testCredentials` - Проверяет $companyId и $apiKey на доступность, возвращает true в случае успеха, false в случае ошибки.

Примеры
-------

[](#примеры)

### Создание транзакции

[](#создание-транзакции)

```
app(Uds::class, [
    'companyId' => 123456789,
    'apiKey' => 'xxxxxxxxxxxxxxx',
])->createTransactionByCode('123456', [
    'total' => 1000,
    'cash' => 1000,
    'points' => 0,
    'number' => '123456',
    'skipLoyaltyTotal' => null,
    'unredeemableTotal' => null,
])
```

### Полный возврат транзакции

[](#полный-возврат-транзакции)

```
app(Uds::class, [
    'companyId' => 123456789,
    'apiKey' => 'xxxxxxxxxxxxxxx',
])->refundTransaction(123456789)
```

### Частичный возврат транзакции

[](#частичный-возврат-транзакции)

```
app(Uds::class, [
    'companyId' => 123456789,
    'apiKey' => 'xxxxxxxxxxxxxxx',
])->refundTransaction(123456789, 100)
```

### Больше примеров можно найти в тестах

[](#больше-примеров-можно-найти-в-тестах)

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance66

Regular maintenance activity

Popularity26

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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

Every ~60 days

Recently: every ~161 days

Total

13

Last Release

207d ago

PHP version history (2 changes)1.0.0PHP &gt;=8.1|8.2

v1.3.6PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/1d03d06109b9abe3f343a67353d431ec04fdbce0578d720fd5a936fa2394ed76?d=identicon)[denis660](/maintainers/denis660)

---

Top Contributors

[![m0nclous](https://avatars.githubusercontent.com/u/18490365?v=4)](https://github.com/m0nclous "m0nclous (11 commits)")[![Nikolay-Mininskiy](https://avatars.githubusercontent.com/u/72444405?v=4)](https://github.com/Nikolay-Mininskiy "Nikolay-Mininskiy (8 commits)")[![denis660](https://avatars.githubusercontent.com/u/53209140?v=4)](https://github.com/denis660 "denis660 (3 commits)")[![Sergey27-dev](https://avatars.githubusercontent.com/u/59311628?v=4)](https://github.com/Sergey27-dev "Sergey27-dev (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sushi-market-laravel-uds-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/sushi-market-laravel-uds-sdk/health.svg)](https://phpackages.com/packages/sushi-market-laravel-uds-sdk)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[statamic/cms

The Statamic CMS Core Package

4.8k3.2M720](/packages/statamic-cms)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[nickurt/laravel-postcodeapi

Universal PostcodeApi for Laravel 11.x/12.x/13.x

97221.2k](/packages/nickurt-laravel-postcodeapi)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

762.6k](/packages/scriptdevelop-whatsapp-manager)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
