116 lines
7.0 KiB
Markdown
116 lines
7.0 KiB
Markdown
# The YooKassa API PHP Client Library
|
||
|
||
[](https://travis-ci.org/yoomoney/yookassa-sdk-php)
|
||
[](https://packagist.org/packages/yoomoney/yookassa-sdk-php)
|
||
[](https://packagist.org/packages/yoomoney/yookassa-sdk-php)
|
||
[](https://packagist.org/packages/yoomoney/yookassa-sdk-php)
|
||
[](https://packagist.org/packages/yoomoney/yookassa-sdk-php)
|
||
|
||
[Russian](README.md) | English
|
||
|
||
This product is used for managing payments under [The YooKassa API](https://yookassa.ru/en/developers/api)
|
||
For usage by those who implemented YooKassa using the API method.
|
||
|
||
## Requirements
|
||
PHP 5.3.2 (or later version) with the libcurl library
|
||
|
||
## Installation
|
||
### Under console using Composer
|
||
|
||
1. Install Composer, a package manager.
|
||
2. In the console, run the following command:
|
||
```bash
|
||
composer require yoomoney/yookassa-sdk-php
|
||
```
|
||
|
||
### Do the following for the composer.json file of your project:
|
||
1. Add a string `"yoomoney/yookassa-sdk-php": "^2.4"` to the list of dependencies of your project in the composer.json file
|
||
```
|
||
...
|
||
"require": {
|
||
"php": ">=5.3.2",
|
||
"yoomoney/yookassa-sdk-php": "^2.4"
|
||
...
|
||
```
|
||
2. Refresh the project's dependencies. In the console, navigate to the catalog with composer.json and run the following command:
|
||
```bash
|
||
composer update
|
||
```
|
||
3. Adjust your project's code to activate automated uploading of files for our product:
|
||
```php
|
||
require __DIR__ . '/vendor/autoload.php';
|
||
```
|
||
|
||
### Manually
|
||
|
||
1. Download [the YooKassa API PHP Client Library archive](https://git.yoomoney.ru/rest/api/latest/projects/SDK/repos/yookassa-sdk-php/archive?format=zip), extract it and copy the lib catalog to the required place of your project.
|
||
2. Adjust your project's code to activate automated uploading of files for our product:
|
||
```php
|
||
require __DIR__ . '/lib/autoload.php';
|
||
```
|
||
|
||
## Commencing work
|
||
|
||
1. Import required classes
|
||
```php
|
||
use YooKassa\Client;
|
||
```
|
||
2. Create a sample of a client object, then set the store's identifier and secret key (you can get them under your YooKassa's Merchant Profile). [Issuing a secret key](https://yookassa.ru/docs/support/merchant/payments/implement/keys?lang=en)
|
||
```php
|
||
$client = new Client();
|
||
$client->setAuth('shopId', 'secretKey');
|
||
```
|
||
3. Call the required API method.
|
||
|
||
[More details in our documentation for the YooKassa API](https://yookassa.ru/en/developers/api#create_payment).
|
||
|
||
[More details in our documentation for the YooKassa SDK](docs/readme.md).
|
||
|
||
## Examples of using the API SDK
|
||
|
||
#### [YooKassa SDK Settings](docs/examples/01-configuration.md)
|
||
* [Additional settings for Curl](docs/examples/01-configuration.md#Установка-дополнительных-настроек-для-Curl)
|
||
* [Authentication](docs/examples/01-configuration.md#Аутентификация)
|
||
* [Statistics about the environment used](docs/examples/01-configuration.md#Статистические-данные-об-используемом-окружении)
|
||
* [Getting information about the store](docs/examples/01-configuration.md#Получение-информации-о-магазине)
|
||
* [Working with Webhook](docs/examples/01-configuration.md#Работа-с-Webhook)
|
||
* [Notifications](docs/examples/01-configuration.md#Входящие-уведомления)
|
||
|
||
#### [Working with payments](docs/examples/02-payments.md)
|
||
* [Request to create a payment](docs/examples/02-payments.md#Запрос-на-создание-платежа)
|
||
* [Request to create a payment via the builder](docs/examples/02-payments.md#Запрос-на-создание-платежа-через-билдер)
|
||
* [Request for partial payment confirmation](docs/examples/02-payments.md#Запрос-на-частичное-подтверждение-платежа)
|
||
* [Request to cancel an incomplete payment](docs/examples/02-payments.md#Запрос-на-отмену-незавершенного-платежа)
|
||
* [Get payment information](docs/examples/02-payments.md#Получить-информацию-о-платеже)
|
||
* [Get a list of payments with filtering](docs/examples/02-payments.md#Получить-список-платежей-с-фильтрацией)
|
||
|
||
#### [Working with refunds](docs/examples/03-refunds.md)
|
||
* [Request to create a refund](docs/examples/03-refunds.md#Запрос-на-создание-возврата)
|
||
* [Request to create a refund via the builder](docs/examples/03-refunds.md#Запрос-на-создание-возврата-через-билдер)
|
||
* [Get refund information](docs/examples/03-refunds.md#Получить-информацию-о-возврате)
|
||
* [Get a list of returns with filtering](docs/examples/03-refunds.md#Получить-список-возвратов-с-фильтрацией)
|
||
|
||
#### [Working with receipts](docs/examples/04-receipts.md)
|
||
* [Request to create a receipt](docs/examples/04-receipts.md#Запрос-на-создание-чека)
|
||
* [Request to create a receipt via the builder](docs/examples/04-receipts.md#Запрос-на-создание-чека-через-билдер)
|
||
* [Get information about the receipt](docs/examples/04-receipts.md#Получить-информацию-о-чеке)
|
||
* [Get a list of receipts with filtering](docs/examples/04-receipts.md#Получить-список-чеков-с-фильтрацией)
|
||
|
||
#### [Working with safe deals](docs/examples/05-deals.md)
|
||
* [Request to create a deal](docs/examples/05-deals.md#Запрос-на-создание-сделки)
|
||
* [Request to create a deal via the builder](docs/examples/05-deals.md#Запрос-на-создание-сделки-через-билдер)
|
||
* [Request to create a payment with info about deal](docs/examples/05-deals.md#Запрос-на-создание-платежа-с-привязкой-к-сделке)
|
||
* [Get deal information](docs/examples/05-deals.md#Получить-информацию-о-сделке)
|
||
* [Get a list of deals with filtering](docs/examples/05-deals.md#Получить-список-сделок-с-фильтрацией)
|
||
|
||
#### [Working with payouts](docs/examples/06-payouts.md)
|
||
* [Request to create a payout](docs/examples/06-payouts.md#Запрос-на-выплату-продавцу)
|
||
* [Get payout information](docs/examples/06-payouts.md#Получить-информацию-о-выплате)
|
||
|
||
#### [Working with personal data](docs/examples/08-personal-data.md)
|
||
* [Creation of personal data](docs/examples/08-personal-data.md#Создание-персональных-данных)
|
||
* [Get information about personal data](docs/examples/08-personal-data.md#Получить-информацию-о-персональных-данных)
|
||
|
||
#### [Working with the list of SBP participants](docs/examples/09-sbp-banks.md)
|
||
* [Get a list of SBP participants](docs/examples/09-sbp-banks.md#Получить-список-участников-СБП)
|