README

Клиент для работы с платежами по API ЮKassa. Подходит тем, у кого способ подключения к ЮKassa называется API.

⚠️ Обновите SDK ЮKassa до 1 января

С 1 января 2026 года основная ставка НДС в России повышается с 20% до 22%.

Если вы работаете по основной ставке, обновите SDK ЮKassa, чтобы со следующего года чеки формировались корректно.

Если не обновить, чеки будут уходить со ставкой 20% — из-за этого возможны вопросы и штрафы от ФНС, а операции придётся исправлять вручную.

Документация по этому SDK

Требования

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

Установка

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

Установите менеджер пакетов Composer.
В консоли выполните команду:
```
composer require yoomoney/yookassa-sdk-php
```

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

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

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

Импортируйте нужные классы:
```
use YooKassa\Client;
```
Создайте экземпляр объекта клиента, задайте идентификатор магазина и секретный ключ (их можно получить в личном кабинете ЮKassa). Как выпустить секретный ключ
```
$client = new Client();
$client->setAuth('shopId', 'secretKey');
```
Вызовите нужный метод API.

Подробнее в документации по API ЮKassa

Подробнее в документации по SDK ЮKassa