PHPackages                             zoon/yookassa-sdk-php - 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. zoon/yookassa-sdk-php

ActiveLibrary[API Development](/categories/api)

zoon/yookassa-sdk-php
=====================

This is a developer tool for integration with YooMoney.

2.7.8(2y ago)01.7k1[1 PRs](https://github.com/zoonru/yookassa-sdk-php/pulls)MITPHPPHP ^8.1

Since Dec 1Pushed 1y ago8 watchersCompare

[ Source](https://github.com/zoonru/yookassa-sdk-php)[ Packagist](https://packagist.org/packages/zoon/yookassa-sdk-php)[ Docs](https://yookassa.ru/developers/api)[ RSS](/packages/zoon-yookassa-sdk-php/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (5)Versions (52)Used By (0)

YooKassa API PHP Client Library
===============================

[](#yookassa-api-php-client-library)

[![Build Status](https://camo.githubusercontent.com/829b3ff77f1906ae7c41fb09b9400e61139d9c312280189c71e9d4f9bf866307/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f796f6f6d6f6e65792f796f6f6b617373612d73646b2d706870)](https://travis-ci.org/yoomoney/yookassa-sdk-php)[![Latest Stable Version](https://camo.githubusercontent.com/bb0dfef93341e9423e2502f8a90024d3ff9d0742f1b8864c768ca92092ed699f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f796f6f6d6f6e65792f796f6f6b617373612d73646b2d7068703f6c6162656c3d737461626c65)](https://packagist.org/packages/yoomoney/yookassa-sdk-php)[![Total Downloads](https://camo.githubusercontent.com/a74daca3b5ed9add349560b06bc0ee1444b3110622711236c1415525a907745c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f796f6f6d6f6e65792f796f6f6b617373612d73646b2d706870)](https://packagist.org/packages/yoomoney/yookassa-sdk-php)[![Monthly Downloads](https://camo.githubusercontent.com/e47f650f9fc662282fdfe62d6dcc3abe37d5a5760ac3810f3f6ca51ee9343cc0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f796f6f6d6f6e65792f796f6f6b617373612d73646b2d706870)](https://packagist.org/packages/yoomoney/yookassa-sdk-php)[![License](https://camo.githubusercontent.com/c491b0ed35ef780fed75cd9c53199d7d63b2b0bd9ffd6672e51fd13cf76f22e6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f796f6f6d6f6e65792f796f6f6b617373612d73646b2d706870)](https://packagist.org/packages/yoomoney/yookassa-sdk-php)

Russian | [English](README.en.md)

Клиент для работы с платежами по [API ЮKassa](https://yookassa.ru/developers/api)Подходит тем, у кого способ подключения к ЮKassa называется API.

[Документация по данному SDK](docs/readme.md).

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

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

PHP 8.1 (и выше) с расширением libcurl

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

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

### В консоли с помощью Composer

[](#в-консоли-с-помощью-composer)

1. Установите менеджер пакетов Composer.
2. В консоли выполните команду

```
composer require zoonru/yookassa-sdk-php
```

### В файле composer.json своего проекта

[](#в-файле-composerjson-своего-проекта)

1. Добавьте строку `"zoonru/yookassa-sdk-php": "^2.6.3"` в список зависимостей вашего проекта в файле composer.json

```
...
    "require": {
        "php": "^8.1",
        "zoonru/yookassa-sdk-php": "^2.6.3"
...

```

2. Обновите зависимости проекта. В консоли перейдите в каталог, где лежит composer.json, и выполните команду:

```
composer update
```

3. В коде вашего проекта подключите автозагрузку файлов нашего клиента:

```
require __DIR__ . '/vendor/autoload.php';
```

### Вручную

[](#вручную)

1. Скачайте [архив YooKassa API PHP Client Library](https://git.yoomoney.ru/rest/api/latest/projects/SDK/repos/yookassa-sdk-php/archive?format=zip), распакуйте его и скопируйте каталог lib в нужное место в вашем проекте.
2. В коде вашего проекта подключите автозагрузку файлов нашего клиента:

```
require __DIR__ . '/lib/autoload.php';
```

Начало работы
-------------

[](#начало-работы)

1. Импортируйте нужные классы

```
use YooKassa\Client;
```

2. Создайте экземпляр объекта клиента, задайте идентификатор магазина и секретный ключ (их можно получить в личном кабинете ЮKassa). [Как выпустить секретный ключ](https://yookassa.ru/docs/support/merchant/payments/implement/keys)

```
$client = new Client();
$client->setAuth('shopId', 'secretKey');
```

3. Вызовите нужный метод API.

    [Подробнее в документации к API ЮKassa](https://yookassa.ru/developers/api#create_payment).

    [Подробнее в документации к SDK ЮKassa](docs/readme.md).

Примеры использования SDK
-------------------------

[](#примеры-использования-sdk)

#### [Настройки SDK API ЮKassa](docs/examples/01-configuration.md)

[](#настройки-sdk-api-юkassa)

- [Аутентификация](docs/examples/01-configuration.md#%D0%90%D1%83%D1%82%D0%B5%D0%BD%D1%82%D0%B8%D1%84%D0%B8%D0%BA%D0%B0%D1%86%D0%B8%D1%8F)
- [Статистические данные об используемом окружении](docs/examples/01-configuration.md#%D0%A1%D1%82%D0%B0%D1%82%D0%B8%D1%81%D1%82%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D0%B5-%D0%BE%D0%B1-%D0%B8%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D1%83%D0%B5%D0%BC%D0%BE%D0%BC-%D0%BE%D0%BA%D1%80%D1%83%D0%B6%D0%B5%D0%BD%D0%B8%D0%B8)
- [Получение информации о магазине](docs/examples/01-configuration.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%B8-%D0%BE-%D0%BC%D0%B0%D0%B3%D0%B0%D0%B7%D0%B8%D0%BD%D0%B5)
- [Работа с Webhook](docs/examples/01-configuration.md#%D0%A0%D0%B0%D0%B1%D0%BE%D1%82%D0%B0-%D1%81-Webhook)
- [Входящие уведомления](docs/examples/01-configuration.md#%D0%92%D1%85%D0%BE%D0%B4%D1%8F%D1%89%D0%B8%D0%B5-%D1%83%D0%B2%D0%B5%D0%B4%D0%BE%D0%BC%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F)

#### [Работа с платежами](docs/examples/02-payments.md)

[](#работа-с-платежами)

- [Запрос на создание платежа](docs/examples/02-payments.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%B0)
- [Запрос на создание платежа через билдер](docs/examples/02-payments.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%B0-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-%D0%B1%D0%B8%D0%BB%D0%B4%D0%B5%D1%80)
- [Запрос на частичное подтверждение платежа](docs/examples/02-payments.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D1%87%D0%B0%D1%81%D1%82%D0%B8%D1%87%D0%BD%D0%BE%D0%B5-%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)
- [Запрос на отмену незавершенного платежа](docs/examples/02-payments.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D0%BE%D1%82%D0%BC%D0%B5%D0%BD%D1%83-%D0%BD%D0%B5%D0%B7%D0%B0%D0%B2%D0%B5%D1%80%D1%88%D0%B5%D0%BD%D0%BD%D0%BE%D0%B3%D0%BE-%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%B0)
- [Получить информацию о платеже](docs/examples/02-payments.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B8%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%BE-%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%B5)
- [Получить список платежей с фильтрацией](docs/examples/02-payments.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B8%D1%82%D1%8C-%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%B5%D0%B9-%D1%81-%D1%84%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D0%B0%D1%86%D0%B8%D0%B5%D0%B9)

#### [Работа с возвратами](docs/examples/03-refunds.md)

[](#работа-с-возвратами)

- [Запрос на создание возврата](docs/examples/03-refunds.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B2%D0%BE%D0%B7%D0%B2%D1%80%D0%B0%D1%82%D0%B0)
- [Запрос на создание возврата через билдер](docs/examples/03-refunds.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B2%D0%BE%D0%B7%D0%B2%D1%80%D0%B0%D1%82%D0%B0-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-%D0%B1%D0%B8%D0%BB%D0%B4%D0%B5%D1%80)
- [Получить информацию о возврате](docs/examples/03-refunds.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B8%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%BE-%D0%B2%D0%BE%D0%B7%D0%B2%D1%80%D0%B0%D1%82%D0%B5)
- [Получить список возвратов с фильтрацией](docs/examples/03-refunds.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B8%D1%82%D1%8C-%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D0%B2%D0%BE%D0%B7%D0%B2%D1%80%D0%B0%D1%82%D0%BE%D0%B2-%D1%81-%D1%84%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D0%B0%D1%86%D0%B8%D0%B5%D0%B9)

#### [Работа с чеками](docs/examples/04-receipts.md)

[](#работа-с-чеками)

- [Запрос на создание чека](docs/examples/04-receipts.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D1%87%D0%B5%D0%BA%D0%B0)
- [Запрос на создание чека через билдер](docs/examples/04-receipts.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D1%87%D0%B5%D0%BA%D0%B0-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-%D0%B1%D0%B8%D0%BB%D0%B4%D0%B5%D1%80)
- [Получить информацию о чеке](docs/examples/04-receipts.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B8%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%BE-%D1%87%D0%B5%D0%BA%D0%B5)
- [Получить список чеков с фильтрацией](docs/examples/04-receipts.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B8%D1%82%D1%8C-%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D1%87%D0%B5%D0%BA%D0%BE%D0%B2-%D1%81-%D1%84%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D0%B0%D1%86%D0%B8%D0%B5%D0%B9)

#### [Работа с безопасными сделками](docs/examples/05-deals.md)

[](#работа-с-безопасными-сделками)

- [Запрос на создание сделки](docs/examples/05-deals.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D1%81%D0%B4%D0%B5%D0%BB%D0%BA%D0%B8)
- [Запрос на создание сделки через билдер](docs/examples/05-deals.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D1%81%D0%B4%D0%B5%D0%BB%D0%BA%D0%B8-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-%D0%B1%D0%B8%D0%BB%D0%B4%D0%B5%D1%80)
- [Запрос на создание платежа с привязкой к сделке](docs/examples/05-deals.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D0%B5-%D0%BF%D0%BB%D0%B0%D1%82%D0%B5%D0%B6%D0%B0-%D1%81-%D0%BF%D1%80%D0%B8%D0%B2%D1%8F%D0%B7%D0%BA%D0%BE%D0%B9-%D0%BA-%D1%81%D0%B4%D0%B5%D0%BB%D0%BA%D0%B5)
- [Запрос на выплату продавцу](docs/examples/05-deals.md#%D0%97%D0%B0%D0%BF%D1%80%D0%BE%D1%81-%D0%BD%D0%B0-%D0%B2%D1%8B%D0%BF%D0%BB%D0%B0%D1%82%D1%83-%D0%BF%D1%80%D0%BE%D0%B4%D0%B0%D0%B2%D1%86%D1%83)
- [Получить информацию о сделке](docs/examples/05-deals.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B8%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%BE-%D1%81%D0%B4%D0%B5%D0%BB%D0%BA%D0%B5)
- [Получить список сделок с фильтрацией](docs/examples/05-deals.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B8%D1%82%D1%8C-%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA-%D1%81%D0%B4%D0%B5%D0%BB%D0%BE%D0%BA-%D1%81-%D1%84%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D0%B0%D1%86%D0%B8%D0%B5%D0%B9)
- [Получить информацию о выплате](docs/examples/05-deals.md#%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B8%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%BE-%D0%B2%D1%8B%D0%BF%D0%BB%D0%B0%D1%82%D0%B5)

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance28

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 72.7% 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

Every ~34 days

Recently: every ~147 days

Total

36

Last Release

788d ago

PHP version history (2 changes)2.0.0PHP >=5.3.0

2.6.3PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/11337ede928f556805cab4f98222f6f8d1f06b460a20e0e603db56fbdb03013c?d=identicon)[zoon](/maintainers/zoon)

---

Top Contributors

[![tonchik-tm](https://avatars.githubusercontent.com/u/2989751?v=4)](https://github.com/tonchik-tm "tonchik-tm (72 commits)")[![SaShaSpi](https://avatars.githubusercontent.com/u/89073248?v=4)](https://github.com/SaShaSpi "SaShaSpi (9 commits)")[![eugenelozn](https://avatars.githubusercontent.com/u/45021873?v=4)](https://github.com/eugenelozn "eugenelozn (6 commits)")[![Alexandr-Penkin](https://avatars.githubusercontent.com/u/7732415?v=4)](https://github.com/Alexandr-Penkin "Alexandr-Penkin (6 commits)")[![DanielLetto2020](https://avatars.githubusercontent.com/u/60618599?v=4)](https://github.com/DanielLetto2020 "DanielLetto2020 (2 commits)")[![danog](https://avatars.githubusercontent.com/u/7339644?v=4)](https://github.com/danog "danog (2 commits)")[![shokhaa](https://avatars.githubusercontent.com/u/38453814?v=4)](https://github.com/shokhaa "shokhaa (1 commits)")[![enotocode](https://avatars.githubusercontent.com/u/20607518?v=4)](https://github.com/enotocode "enotocode (1 commits)")

---

Tags

apisdkpaymentsyookassayoomoney

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/zoon-yookassa-sdk-php/health.svg)

```
[![Health](https://phpackages.com/badges/zoon-yookassa-sdk-php/health.svg)](https://phpackages.com/packages/zoon-yookassa-sdk-php)
```

###  Alternatives

[transbank/transbank-sdk

Transbank SDK

62626.4k12](/packages/transbank-transbank-sdk)

PHPackages © 2026

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