yookassa-sdk-php/README.md

# YooKassa API PHP Client Library

[![Latest Stable Version](https://img.shields.io/packagist/v/yoomoney/yookassa-sdk-php?label=stable)](https://packagist.org/packages/yoomoney/yookassa-sdk-php)
[![Total Downloads](https://img.shields.io/packagist/dt/yoomoney/yookassa-sdk-php)](https://packagist.org/packages/yoomoney/yookassa-sdk-php)
[![Monthly Downloads](https://img.shields.io/packagist/dm/yoomoney/yookassa-sdk-php)](https://packagist.org/packages/yoomoney/yookassa-sdk-php)
[![License](https://img.shields.io/packagist/l/yoomoney/yookassa-sdk-php)](https://packagist.org/packages/yoomoney/yookassa-sdk-php)

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

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

> ⚠️
> **Обновите SDK ЮKassa до 1 января**
>
> С 1 января 2026 года основная ставка НДС в России повышается с 20% до 22%.
>
> Если вы работаете по основной ставке, обновите SDK ЮKassa, чтобы со следующего года чеки формировались корректно.
>
> Если не обновить, чеки будут уходить со ставкой 20% — из-за этого возможны вопросы и штрафы от ФНС, а операции придётся исправлять вручную.

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

## Требования
PHP 8.0 (и выше) с расширением libcurl

## Установка
### В консоли с помощью Composer

1. [Установите менеджер пакетов Composer](https://getcomposer.org/download/).
2. В консоли выполните команду:
```bash
composer require yoomoney/yookassa-sdk-php
```

### В файле composer.json своего проекта
1. Добавьте строку `"yoomoney/yookassa-sdk-php": "^3.0"` в список зависимостей вашего проекта в файле composer.json:
```
...
    "require": {
        "php": ">=8.0",
        "yoomoney/yookassa-sdk-php": "^3.0"
...
```
2. Обновите зависимости проекта. В консоли перейдите в каталог, где лежит composer.json, и выполните команду:
```bash
composer update
```
3. В коде вашего проекта подключите автозагрузку файлов нашего клиента:
```php
require __DIR__ . '/vendor/autoload.php';
```

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

1. Импортируйте нужные классы:
```php
use YooKassa\Client;
```
2. Создайте экземпляр объекта клиента, задайте идентификатор магазина и секретный ключ (их можно получить в личном кабинете ЮKassa). [Как выпустить секретный ключ](https://yookassa.ru/docs/support/merchant/payments/implement/keys)
```php
$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 версии 3.x](docs/examples/migration-3x.md)

#### [Настройки SDK API ЮKassa](docs/examples/01-configuration.md)
* [Установка дополнительных настроек для Curl](docs/examples/01-configuration.md#Установка-дополнительных-настроек-для-Curl)
* [Аутентификация](docs/examples/01-configuration.md#Аутентификация)
* [Статистические данные об используемом окружении](docs/examples/01-configuration.md#Статистические-данные-об-используемом-окружении)
* [Получение информации о магазине](docs/examples/01-configuration.md#Получение-информации-о-магазине)
* [Работа с Webhook](docs/examples/01-configuration.md#Работа-с-Webhook)
* [Входящие уведомления](docs/examples/01-configuration.md#Входящие-уведомления)

#### [Работа с платежами](docs/examples/02-payments.md)
* [Запрос на создание платежа](docs/examples/02-payments.md#Запрос-на-создание-платежа)
* [Запрос на создание платежа через билдер](docs/examples/02-payments.md#Запрос-на-создание-платежа-через-билдер)
* [Запрос на частичное подтверждение платежа](docs/examples/02-payments.md#Запрос-на-частичное-подтверждение-платежа)
* [Запрос на отмену незавершенного платежа](docs/examples/02-payments.md#Запрос-на-отмену-незавершенного-платежа)
* [Получить информацию о платеже](docs/examples/02-payments.md#Получить-информацию-о-платеже)
* [Получить список платежей с фильтрацией](docs/examples/02-payments.md#Получить-список-платежей-с-фильтрацией)

#### [Работа с возвратами](docs/examples/03-refunds.md)
* [Запрос на создание возврата](docs/examples/03-refunds.md#Запрос-на-создание-возврата)
* [Запрос на создание возврата через билдер](docs/examples/03-refunds.md#Запрос-на-создание-возврата-через-билдер)
* [Получить информацию о возврате](docs/examples/03-refunds.md#Получить-информацию-о-возврате)
* [Получить список возвратов с фильтрацией](docs/examples/03-refunds.md#Получить-список-возвратов-с-фильтрацией)

#### [Работа с чеками](docs/examples/04-receipts.md)
* [Запрос на создание чека](docs/examples/04-receipts.md#Запрос-на-создание-чека)
* [Запрос на создание чека через билдер](docs/examples/04-receipts.md#Запрос-на-создание-чека-через-билдер)
* [Получить информацию о чеке](docs/examples/04-receipts.md#Получить-информацию-о-чеке)
* [Получить список чеков с фильтрацией](docs/examples/04-receipts.md#Получить-список-чеков-с-фильтрацией)

#### [Работа с безопасными сделками](docs/examples/05-deals.md)
* [Запрос на создание сделки](docs/examples/05-deals.md#Запрос-на-создание-сделки)
* [Запрос на создание сделки через билдер](docs/examples/05-deals.md#Запрос-на-создание-сделки-через-билдер)
* [Запрос на создание платежа с привязкой к сделке](docs/examples/05-deals.md#Запрос-на-создание-платежа-с-привязкой-к-сделке)
* [Получить информацию о сделке](docs/examples/05-deals.md#Получить-информацию-о-сделке)
* [Получить список сделок с фильтрацией](docs/examples/05-deals.md#Получить-список-сделок-с-фильтрацией)

#### [Работа с выплатами](docs/examples/06-payouts.md)
* [Запрос на выплату продавцу](docs/examples/06-payouts.md#Запрос-на-выплату-продавцу)
  * [Проведение выплаты на банковскую карту](docs/examples/06-payouts.md#Проведение-выплаты-на-банковскую-карту)
  * [Проведение выплаты в кошелек ЮMoney](docs/examples/06-payouts.md#Проведение-выплаты-в-кошелек-юmoney)
  * [Проведение выплаты через СБП](docs/examples/06-payouts.md#Проведение-выплаты-через-сбп)
  * [Выплаты самозанятым](docs/examples/06-payouts.md#Выплаты-самозанятым)
  * [Проведение выплаты по безопасной сделке](docs/examples/06-payouts.md#Проведение-выплаты-по-безопасной-сделке)
* [Получить информацию о выплате](docs/examples/06-payouts.md#Получить-информацию-о-выплате)

#### [Работа с самозанятыми](docs/examples/07-self-employed.md)
* [Запрос на создание самозанятого](docs/examples/07-self-employed.md#Запрос-на-создание-самозанятого)
* [Получить информацию о самозанятом](docs/examples/07-self-employed.md#Получить-информацию-о-самозанятом)

#### [Работа с персональными данными](docs/examples/08-personal-data.md)
* [Создание персональных данных](docs/examples/08-personal-data.md#Создание-персональных-данных)
* [Получить информацию о персональных данных](docs/examples/08-personal-data.md#Получить-информацию-о-персональных-данных)

#### [Работа со списком участников СБП](docs/examples/09-sbp-banks.md)
* [Получить список участников СБП](docs/examples/09-sbp-banks.md#Получить-список-участников-СБП)

#### [Работа со счетами](docs/examples/10-invoices.md)
* [Запрос на создание счета](docs/examples/10-invoices.md#Запрос-на-создание-счета)
* [Запрос на создание счета через билдер](docs/examples/10-invoices.md#Запрос-на-создание-счета-через-билдер)
* [Получить информацию о счете](docs/examples/10-invoices.md#Получить-информацию-о-счете)

#### [Работа со способами оплаты](docs/examples/11-payment-methods.md)
* [Запрос на создание способа оплаты](docs/examples/11-payment-methods.md#Запрос-на-создание-способа-оплаты)
* [Запрос на создание способа оплаты через билдер](docs/examples/11-payment-methods.md#Запрос-на-создание-способа-оплаты-через-билдер)
* [Получить информацию о способе оплаты](docs/examples/11-payment-methods.md#Получить-информацию-о-способе-оплаты)

#### [Работа с кассовыми ссылками](docs/examples/12-pos-links.md)
* [Запрос на создание кассовой ссылки](docs/examples/12-pos-links.md#Запрос-на-создание-кассовой-ссылки)
* [Получить информацию о кассовой ссылке](docs/examples/12-pos-links.md#Получить-информацию-о-кассовой-ссылке)
* [Активировать кассовую ссылку](docs/examples/12-pos-links.md#Активировать-кассовую-ссылку)
* [Деактивировать кассовую ссылку](docs/examples/12-pos-links.md#Деактивировать-кассовую-ссылку)
* [Привязать торговую точку к кассовой ссылке](docs/examples/12-pos-links.md#Привязать-торговую-точку-к-кассовой-ссылке)