# [YooKassa API SDK](../home.md) # Class: \YooKassa\Client ### Namespace: [\YooKassa](../namespaces/yookassa.md) --- **Summary:** Класс клиента API --- ### Examples 01-client.php 3 7 Создание клиента ```php ``` --- ### Constants | Visibility | Name | Flag | Summary | | ----------:| ---- | ---- | ------- | | public | [ME_PATH](../classes/YooKassa-Client-BaseClient.md#constant_ME_PATH) | | Точка входа для запроса к API по магазину | | public | [PAYMENTS_PATH](../classes/YooKassa-Client-BaseClient.md#constant_PAYMENTS_PATH) | | Точка входа для запросов к API по платежам | | public | [REFUNDS_PATH](../classes/YooKassa-Client-BaseClient.md#constant_REFUNDS_PATH) | | Точка входа для запросов к API по возвратам | | public | [WEBHOOKS_PATH](../classes/YooKassa-Client-BaseClient.md#constant_WEBHOOKS_PATH) | | Точка входа для запросов к API по вебхукам | | public | [RECEIPTS_PATH](../classes/YooKassa-Client-BaseClient.md#constant_RECEIPTS_PATH) | | Точка входа для запросов к API по чекам | | public | [DEALS_PATH](../classes/YooKassa-Client-BaseClient.md#constant_DEALS_PATH) | | Точка входа для запросов к API по сделкам | | public | [PAYOUTS_PATH](../classes/YooKassa-Client-BaseClient.md#constant_PAYOUTS_PATH) | | Точка входа для запросов к API по выплатам | | public | [PERSONAL_DATA_PATH](../classes/YooKassa-Client-BaseClient.md#constant_PERSONAL_DATA_PATH) | | Точка входа для запросов к API по персональным данным | | public | [SBP_BANKS_PATH](../classes/YooKassa-Client-BaseClient.md#constant_SBP_BANKS_PATH) | | Точка входа для запросов к API по участникам СБП | | public | [SELF_EMPLOYED_PATH](../classes/YooKassa-Client-BaseClient.md#constant_SELF_EMPLOYED_PATH) | | Точка входа для запросов к API по самозанятым | | public | [IDEMPOTENCY_KEY_HEADER](../classes/YooKassa-Client-BaseClient.md#constant_IDEMPOTENCY_KEY_HEADER) | | Имя HTTP заголовка, используемого для передачи idempotence key | | public | [DEFAULT_DELAY](../classes/YooKassa-Client-BaseClient.md#constant_DEFAULT_DELAY) | | Значение по умолчанию времени ожидания между запросами при отправке повторного запроса в случае получения ответа с HTTP статусом 202 | | public | [DEFAULT_TRIES_COUNT](../classes/YooKassa-Client-BaseClient.md#constant_DEFAULT_TRIES_COUNT) | | Значение по умолчанию количества попыток получения информации от API если пришёл ответ с HTTP статусом 202 | | public | [DEFAULT_ATTEMPTS_COUNT](../classes/YooKassa-Client-BaseClient.md#constant_DEFAULT_ATTEMPTS_COUNT) | | Значение по умолчанию количества попыток получения информации от API если пришёл ответ с HTTP статусом 202 | | public | [SDK_VERSION](../classes/YooKassa-Client.md#constant_SDK_VERSION) | | Текущая версия библиотеки | --- ### Properties | Visibility | Name | Flag | Summary | | ----------:| ---- | ---- | ------- | | protected | [$apiClient](../classes/YooKassa-Client-BaseClient.md#property_apiClient) | | CURL клиент | | protected | [$attempts](../classes/YooKassa-Client-BaseClient.md#property_attempts) | | Количество повторных запросов при ответе API статусом 202 | | protected | [$config](../classes/YooKassa-Client-BaseClient.md#property_config) | | Настройки для CURL клиента | | protected | [$logger](../classes/YooKassa-Client-BaseClient.md#property_logger) | | Объект для логирования работы SDK | | protected | [$login](../classes/YooKassa-Client-BaseClient.md#property_login) | | shopId магазина | | protected | [$password](../classes/YooKassa-Client-BaseClient.md#property_password) | | Секретный ключ магазина | | protected | [$timeout](../classes/YooKassa-Client-BaseClient.md#property_timeout) | | Время через которое будут осуществляться повторные запросы | --- ### Methods | Visibility | Name | Flag | Summary | | ----------:| ---- | ---- | ------- | | public | [__construct()](../classes/YooKassa-Client-BaseClient.md#method___construct) | | Constructor | | public | [addWebhook()](../classes/YooKassa-Client.md#method_addWebhook) | | Создание Webhook | | public | [cancelPayment()](../classes/YooKassa-Client.md#method_cancelPayment) | | Отменить незавершенную оплату заказа. | | public | [capturePayment()](../classes/YooKassa-Client.md#method_capturePayment) | | Подтверждение платежа | | public | [createDeal()](../classes/YooKassa-Client.md#method_createDeal) | | Создание сделки. | | public | [createPayment()](../classes/YooKassa-Client.md#method_createPayment) | | Создание платежа. | | public | [createPayout()](../classes/YooKassa-Client.md#method_createPayout) | | Создание выплаты. | | public | [createPersonalData()](../classes/YooKassa-Client.md#method_createPersonalData) | | Создание персональных данных | | public | [createReceipt()](../classes/YooKassa-Client.md#method_createReceipt) | | Отправка чека в облачную кассу | | public | [createRefund()](../classes/YooKassa-Client.md#method_createRefund) | | Проведение возврата платежа | | public | [createSelfEmployed()](../classes/YooKassa-Client.md#method_createSelfEmployed) | | Создание самозанятого. | | public | [getApiClient()](../classes/YooKassa-Client-BaseClient.md#method_getApiClient) | | Возвращает CURL клиента для работы с API | | public | [getConfig()](../classes/YooKassa-Client-BaseClient.md#method_getConfig) | | Возвращает настройки клиента | | public | [getDealInfo()](../classes/YooKassa-Client.md#method_getDealInfo) | | Получить информацию о сделке | | public | [getDeals()](../classes/YooKassa-Client.md#method_getDeals) | | Получить список сделок магазина | | public | [getPaymentInfo()](../classes/YooKassa-Client.md#method_getPaymentInfo) | | Получить информацию о платеже | | public | [getPayments()](../classes/YooKassa-Client.md#method_getPayments) | | Получить список платежей магазина | | public | [getPayoutInfo()](../classes/YooKassa-Client.md#method_getPayoutInfo) | | Получить информацию о выплате | | public | [getPersonalDataInfo()](../classes/YooKassa-Client.md#method_getPersonalDataInfo) | | Получить информацию о персональных данных | | public | [getReceiptInfo()](../classes/YooKassa-Client.md#method_getReceiptInfo) | | Получить информацию о чеке | | public | [getReceipts()](../classes/YooKassa-Client.md#method_getReceipts) | | Получить список чеков магазина | | public | [getRefundInfo()](../classes/YooKassa-Client.md#method_getRefundInfo) | | Получить информацию о возврате | | public | [getRefunds()](../classes/YooKassa-Client.md#method_getRefunds) | | Получить список возвратов платежей | | public | [getSbpBanks()](../classes/YooKassa-Client.md#method_getSbpBanks) | | Получить список участников СБП | | public | [getSelfEmployedInfo()](../classes/YooKassa-Client.md#method_getSelfEmployedInfo) | | Получить информацию о самозанятом | | public | [getWebhooks()](../classes/YooKassa-Client.md#method_getWebhooks) | | Список созданных Webhook | | public | [isNotificationIPTrusted()](../classes/YooKassa-Client-BaseClient.md#method_isNotificationIPTrusted) | | Метод проверяет, находится ли IP адрес среди IP адресов Юkassa, с которых отправляются уведомления | | public | [me()](../classes/YooKassa-Client.md#method_me) | | Информация о магазине | | public | [removeWebhook()](../classes/YooKassa-Client.md#method_removeWebhook) | | Удаление Webhook | | public | [setApiClient()](../classes/YooKassa-Client-BaseClient.md#method_setApiClient) | | Устанавливает CURL клиента для работы с API | | public | [setAuth()](../classes/YooKassa-Client-BaseClient.md#method_setAuth) | | Устанавливает авторизацию по логин/паролю | | public | [setAuthToken()](../classes/YooKassa-Client-BaseClient.md#method_setAuthToken) | | Устанавливает авторизацию по Oauth-токену | | public | [setConfig()](../classes/YooKassa-Client-BaseClient.md#method_setConfig) | | Устанавливает настройки клиента | | public | [setLogger()](../classes/YooKassa-Client-BaseClient.md#method_setLogger) | | Устанавливает логгер приложения | | public | [setMaxRequestAttempts()](../classes/YooKassa-Client-BaseClient.md#method_setMaxRequestAttempts) | | Установка значения количества попыток повторных запросов при статусе 202 | | public | [setRetryTimeout()](../classes/YooKassa-Client-BaseClient.md#method_setRetryTimeout) | | Установка значения задержки между повторными запросами | | protected | [decodeData()](../classes/YooKassa-Client-BaseClient.md#method_decodeData) | | Декодирует JSON строку в массив данных | | protected | [delay()](../classes/YooKassa-Client-BaseClient.md#method_delay) | | Задержка между повторными запросами | | protected | [encodeData()](../classes/YooKassa-Client-BaseClient.md#method_encodeData) | | Кодирует массив данных в JSON строку | | protected | [execute()](../classes/YooKassa-Client-BaseClient.md#method_execute) | | Выполнение запроса и обработка 202 статуса | | protected | [handleError()](../classes/YooKassa-Client-BaseClient.md#method_handleError) | | Выбрасывает исключение по коду ошибки | --- ### Details * File: [lib/Client.php](../../lib/Client.php) * Package: YooKassa * Class Hierarchy: * [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) * \YooKassa\Client --- ### Tags | Tag | Version | Description | | --- | ------- | ----------- | | since | 1.0.1 | | --- ## Constants ###### ME_PATH Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Точка входа для запроса к API по магазину ```php ME_PATH = '/me' ``` ###### PAYMENTS_PATH Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Точка входа для запросов к API по платежам ```php PAYMENTS_PATH = '/payments' ``` ###### REFUNDS_PATH Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Точка входа для запросов к API по возвратам ```php REFUNDS_PATH = '/refunds' ``` ###### WEBHOOKS_PATH Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Точка входа для запросов к API по вебхукам ```php WEBHOOKS_PATH = '/webhooks' ``` ###### RECEIPTS_PATH Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Точка входа для запросов к API по чекам ```php RECEIPTS_PATH = '/receipts' ``` ###### DEALS_PATH Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Точка входа для запросов к API по сделкам ```php DEALS_PATH = '/deals' ``` ###### PAYOUTS_PATH Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Точка входа для запросов к API по выплатам ```php PAYOUTS_PATH = '/payouts' ``` ###### PERSONAL_DATA_PATH Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Точка входа для запросов к API по персональным данным ```php PERSONAL_DATA_PATH = '/personal_data' ``` ###### SBP_BANKS_PATH Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Точка входа для запросов к API по участникам СБП ```php SBP_BANKS_PATH = '/sbp_banks' ``` ###### SELF_EMPLOYED_PATH Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Точка входа для запросов к API по самозанятым ```php SELF_EMPLOYED_PATH = '/self_employed' ``` ###### IDEMPOTENCY_KEY_HEADER Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Имя HTTP заголовка, используемого для передачи idempotence key ```php IDEMPOTENCY_KEY_HEADER = 'Idempotence-Key' ``` ###### DEFAULT_DELAY Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Значение по умолчанию времени ожидания между запросами при отправке повторного запроса в случае получения ответа с HTTP статусом 202 ```php DEFAULT_DELAY = 1800 ``` ###### DEFAULT_TRIES_COUNT Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Значение по умолчанию количества попыток получения информации от API если пришёл ответ с HTTP статусом 202 ```php DEFAULT_TRIES_COUNT = 3 ``` ###### DEFAULT_ATTEMPTS_COUNT Inherited from [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) Значение по умолчанию количества попыток получения информации от API если пришёл ответ с HTTP статусом 202 ```php DEFAULT_ATTEMPTS_COUNT = 3 ``` ###### SDK_VERSION Текущая версия библиотеки ```php SDK_VERSION = '2.8.0' ``` --- ## Properties #### protected $apiClient : null|\YooKassa\Client\ApiClientInterface --- **Summary** CURL клиент **Type:** ApiClientInterface **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) #### protected $attempts : int --- **Summary** Количество повторных запросов при ответе API статусом 202 ***Description*** Значение по умолчанию 3 **Type:** int **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) #### protected $config : array --- **Summary** Настройки для CURL клиента **Type:** array **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) #### protected $logger : \Psr\Log\LoggerInterface|null --- **Summary** Объект для логирования работы SDK **Type:** LoggerInterface|null **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) #### protected $login : string|int --- **Summary** shopId магазина **Type:** string|int **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) #### protected $password : string --- **Summary** Секретный ключ магазина **Type:** string **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) #### protected $timeout : int --- **Summary** Время через которое будут осуществляться повторные запросы ***Description*** Значение по умолчанию - 1800 миллисекунд. **Type:** int Значение в миллисекундах **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) --- ## Methods #### public __construct() : mixed ```php public __construct(\YooKassa\Client\ApiClientInterface|null $apiClient = null, \YooKassa\Helpers\Config\ConfigurationLoaderInterface|null $configLoader = null) : mixed ``` **Summary** Constructor **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Client\ApiClientInterface OR null | apiClient | | | \YooKassa\Helpers\Config\ConfigurationLoaderInterface OR null | configLoader | | **Returns:** mixed - #### public addWebhook() : \YooKassa\Model\Webhook\Webhook|null ```php public addWebhook(\YooKassa\Model\Webhook\Webhook|array $request, string|null $idempotencyKey = null) : \YooKassa\Model\Webhook\Webhook|null ``` **Summary** Создание Webhook **Description** Запрос позволяет подписаться на уведомления о событии (например, на переход платежа в статус successed). **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Model\Webhook\Webhook OR array | request | | | string OR null | idempotencyKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Model\Webhook\Webhook|null - ##### Examples: 01-client.php 192 33 Создание Webhook: ```php ``` #### public cancelPayment() : \YooKassa\Request\Payments\Payment\CancelResponse|null ```php public cancelPayment(string $paymentId, string|null $idempotencyKey = null) : \YooKassa\Request\Payments\Payment\CancelResponse|null ``` **Summary** Отменить незавершенную оплату заказа. **Description** Отменяет платеж, находящийся в статусе `waiting_for_capture`. Отмена платежа значит, что вы не готовы выдать пользователю товар или оказать услугу. Как только вы отменяете платеж, мы начинаем возвращать деньги на счет плательщика. Для платежей банковскими картами отмена происходит мгновенно. Для остальных способов оплаты возврат может занимать до нескольких дней. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | paymentId | Идентификатор платежа | | string OR null | idempotencyKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Request\Payments\Payment\CancelResponse|null - ##### Examples: 01-client.php 87 9 Отменить незавершенную оплату заказа: ```php ``` #### public capturePayment() : \YooKassa\Request\Payments\Payment\CreateCaptureResponse|null ```php public capturePayment(\YooKassa\Request\Payments\Payment\CreateCaptureRequestInterface|array $captureRequest, string $paymentId, string|null $idempotencyKey = null) : \YooKassa\Request\Payments\Payment\CreateCaptureResponse|null ``` **Summary** Подтверждение платежа **Description** Подтверждает вашу готовность принять платеж. Платеж можно подтвердить, только если он находится в статусе `waiting_for_capture`. Если платеж подтвержден успешно — значит, оплата прошла, и вы можете выдать товар или оказать услугу пользователю. На следующий день после подтверждения платеж попадет в реестр, и ЮKassa переведет деньги на ваш расчетный счет. Если вы не подтверждаете платеж до момента, указанного в `expire_at`, по умолчанию он отменяется, а деньги возвращаются пользователю. При оплате банковской картой у вас есть 7 дней на подтверждение платежа. Для остальных способов оплаты платеж необходимо подтвердить в течение 6 часов. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\Payments\Payment\CreateCaptureRequestInterface OR array | captureRequest | | | string | paymentId | Идентификатор платежа | | string OR null | idempotencyKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Request\Payments\Payment\CreateCaptureResponse|null - ##### Examples: 01-client.php 51 34 Подтверждение платежа: ```php ``` #### public createDeal() : \YooKassa\Request\Deals\CreateDealResponse|null ```php public createDeal(\YooKassa\Request\Deals\CreateDealRequestInterface|array $deal, string|null $idempotenceKey = null) : \YooKassa\Request\Deals\CreateDealResponse|null ``` **Summary** Создание сделки. **Description** Запрос позволяет создать сделку, в рамках которой необходимо принять оплату от покупателя и перечислить ее продавцу. Необходимо указать следующие параметры: Дополнительные параметры: **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\Deals\CreateDealRequestInterface OR array | deal | | | string OR null | idempotenceKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Request\Deals\CreateDealResponse|null - ##### Examples: 01-client.php 300 18 Запрос на создание сделки: ```php ``` #### public createPayment() : \YooKassa\Request\Payments\CreatePaymentResponse|null ```php public createPayment(\YooKassa\Request\Payments\CreatePaymentRequestInterface|array $payment, string|null $idempotenceKey = null) : \YooKassa\Request\Payments\CreatePaymentResponse|null ``` **Summary** Создание платежа. **Description** Чтобы принять оплату, необходимо создать объект платежа — `Payment`. Он содержит всю необходимую информацию для проведения оплаты (сумму, валюту и статус). У платежа линейный жизненный цикл, он последовательно переходит из статуса в статус. Необходимо указать один из параметров: Если не указан ни один параметр и `confirmation.type = redirect`, то в качестве `confirmation_url` возвращается ссылка, по которой пользователь сможет самостоятельно выбрать подходящий способ оплаты. Дополнительные параметры: **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\Payments\CreatePaymentRequestInterface OR array | payment | | | string OR null | idempotenceKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Request\Payments\CreatePaymentResponse|null - ##### Examples: 01-client.php 21 28 Запрос на создание платежа: ```php ``` #### public createPayout() : \YooKassa\Request\Payouts\CreatePayoutResponse|null ```php public createPayout(\YooKassa\Request\Payouts\CreatePayoutRequestInterface|array $payout, string|null $idempotenceKey = null) : \YooKassa\Request\Payouts\CreatePayoutResponse|null ``` **Summary** Создание выплаты. **Description** Запрос позволяет перечислить продавцу оплату за выполненную услугу или проданный товар в рамках Безопасной сделки. Выплату можно сделать на банковскую карту или на кошелек ЮMoney. Обязательный параметр: Необходимо указать один из параметров: Дополнительные параметры: **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\Payouts\CreatePayoutRequestInterface OR array | payout | | | string OR null | idempotenceKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Request\Payouts\CreatePayoutResponse|null - ##### Examples: 01-client.php 358 27 Запрос на создание выплаты: ```php ``` #### public createPersonalData() : \YooKassa\Request\PersonalData\PersonalDataResponse|null ```php public createPersonalData(\YooKassa\Request\PersonalData\CreatePersonalDataRequestInterface|array $request, string|null $idempotencyKey = null) : \YooKassa\Request\PersonalData\PersonalDataResponse|null ``` **Summary** Создание персональных данных **Description** Используйте этот запрос, чтобы создать в ЮKassa [объект персональных данных](#personal_data_object). В запросе необходимо передать фамилию, имя, отчество пользователя и указать, с какой целью эти данные будут использоваться. Идентификатор созданного объекта персональных данных необходимо использовать в запросе на проведение выплаты через СБП с проверкой получателя. [Подробнее о выплатах с проверкой получателя](/developers/payouts/scenario-extensions/recipient-check) **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\PersonalData\CreatePersonalDataRequestInterface OR array | request | | | string OR null | idempotencyKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Request\PersonalData\PersonalDataResponse|null - Объект персональных данных ##### Examples: 01-client.php 397 16 Запрос на создание персональных данных: ```php ``` #### public createReceipt() : \YooKassa\Request\Receipts\AbstractReceiptResponse|null ```php public createReceipt(\YooKassa\Request\Receipts\CreatePostReceiptRequestInterface|array $receipt, string|null $idempotenceKey = null) : \YooKassa\Request\Receipts\AbstractReceiptResponse|null ``` **Summary** Отправка чека в облачную кассу **Description** Создает объект чека — `Receipt`. Возвращает успешно созданный чек по уникальному идентификатору платежа или возврата. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\Receipts\CreatePostReceiptRequestInterface OR array | receipt | | | string OR null | idempotenceKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \YooKassa\Common\Exceptions\AuthorizeException | Ошибка авторизации. Не установлен заголовок. | | \Exception | | **Returns:** \YooKassa\Request\Receipts\AbstractReceiptResponse|null - ##### Examples: 01-client.php 98 34 Запрос на создание чека: ```php ``` #### public createRefund() : \YooKassa\Request\Refunds\CreateRefundResponse|null ```php public createRefund(\YooKassa\Request\Refunds\CreateRefundRequestInterface|array $request, string|null $idempotencyKey = null) : \YooKassa\Request\Refunds\CreateRefundResponse|null ``` **Summary** Проведение возврата платежа **Description** Создает объект возврата — `Refund`. Возвращает успешно завершенный платеж по уникальному идентификатору этого платежа. Создание возврата возможно только для платежей в статусе `succeeded`. Комиссии за проведение возврата нет. Комиссия, которую ЮKassa берёт за проведение исходного платежа, не возвращается. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\Refunds\CreateRefundRequestInterface OR array | request | | | string OR null | idempotencyKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Request\Refunds\CreateRefundResponse|null - ##### Examples: 01-client.php 134 26 Запрос на создание возврата: ```php ``` #### public createSelfEmployed() : \YooKassa\Request\SelfEmployed\SelfEmployedResponse|null ```php public createSelfEmployed(\YooKassa\Request\SelfEmployed\SelfEmployedRequest|array $selfEmployed, string|null $idempotenceKey = null) : \YooKassa\Request\SelfEmployed\SelfEmployedResponse|null ``` **Summary** Создание самозанятого. **Description** Используйте этот запрос, чтобы создать в ЮKassa [объект самозанятого](https://yookassa.ru/developers/api?codeLang=bash#self_employed_object). В запросе необходимо передать ИНН или телефон самозанятого для идентификации в сервисе Мой налог, сценарий подтверждения пользователем заявки ЮMoney на получение прав для регистрации чеков и описание самозанятого. Идентификатор созданного объекта самозанятого необходимо использовать в запросе на проведение выплаты. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\SelfEmployed\SelfEmployedRequest OR array | selfEmployed | | | string OR null | idempotenceKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Request\SelfEmployed\SelfEmployedResponse|null - ##### Examples: 01-client.php 425 14 Запрос на создание самозанятого: ```php ``` #### public getApiClient() : \YooKassa\Client\ApiClientInterface ```php public getApiClient() : \YooKassa\Client\ApiClientInterface ``` **Summary** Возвращает CURL клиента для работы с API **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) **Returns:** \YooKassa\Client\ApiClientInterface - #### public getConfig() : array ```php public getConfig() : array ``` **Summary** Возвращает настройки клиента **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) **Returns:** array - #### public getDealInfo() : \YooKassa\Model\DealInterface|null ```php public getDealInfo(string $dealId) : \YooKassa\Model\DealInterface|null ``` **Summary** Получить информацию о сделке **Description** Запрос позволяет получить информацию о текущем состоянии сделки по её уникальному идентификатору. Выдает объект чека {@link} в актуальном статусе. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | dealId | Идентификатор сделки | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Model\DealInterface|null - ##### Examples: 01-client.php 320 8 Получить информацию о сделке: ```php ``` #### public getDeals() : \YooKassa\Request\Deals\DealsResponse|null ```php public getDeals(\YooKassa\Request\Deals\DealsRequestInterface|array|null $filter = null) : \YooKassa\Request\Deals\DealsResponse|null ``` **Summary** Получить список сделок магазина **Description** Запрос позволяет получить список сделок, отфильтрованный по заданным критериям. В ответ на запрос вернется список сделок с учетом переданных параметров. В списке будет информация о сделках, созданных за последние 3 года. Список будет отсортирован по времени создания сделок в порядке убывания. Если результатов больше, чем задано в `limit`, список будет выводиться фрагментами. В этом случае в ответе на запрос вернется фрагмент списка и параметр `next_cursor` с указателем на следующий фрагмент. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\Deals\DealsRequestInterface OR array OR null | filter | | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Request\Deals\DealsResponse|null - ##### Examples: 01-client.php 330 27 Получить список сделок с фильтрацией: ```php ``` #### public getPaymentInfo() : \YooKassa\Model\PaymentInterface|null ```php public getPaymentInfo(string $paymentId) : \YooKassa\Model\PaymentInterface|null ``` **Summary** Получить информацию о платеже **Description** Запрос позволяет получить информацию о текущем состоянии платежа по его уникальному идентификатору. Выдает объект платежа {@link} в актуальном статусе. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | paymentId | Идентификатор платежа | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Model\PaymentInterface|null - Объект платежа ##### Examples: 01-client.php 162 8 Получить информацию о платеже: ```php ``` #### public getPayments() : \YooKassa\Request\Payments\PaymentsResponse|null ```php public getPayments(\YooKassa\Request\Payments\PaymentsRequestInterface|array|null $filter = null) : \YooKassa\Request\Payments\PaymentsResponse|null ``` **Summary** Получить список платежей магазина **Description** Запрос позволяет получить список платежей, отфильтрованный по заданным критериям. В ответ на запрос вернется список платежей с учетом переданных параметров. В списке будет информация о платежах, созданных за последние 3 года. Список будет отсортирован по времени создания платежей в порядке убывания. Если результатов больше, чем задано в `limit`, список будет выводиться фрагментами. В этом случае в ответе на запрос вернется фрагмент списка и параметр `next_cursor` с указателем на следующий фрагмент. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\Payments\PaymentsRequestInterface OR array OR null | filter | | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Request\Payments\PaymentsResponse|null - ##### Examples: 01-client.php 227 23 Получить список платежей магазина с фильтрацией: ```php ``` #### public getPayoutInfo() : \YooKassa\Model\PayoutInterface|null ```php public getPayoutInfo(string $payoutId) : \YooKassa\Model\PayoutInterface|null ``` **Summary** Получить информацию о выплате **Description** Запрос позволяет получить информацию о текущем состоянии выплаты по ее уникальному идентификатору. Выдает объект выплаты {@link} в актуальном статусе. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | payoutId | Идентификатор выплаты | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Model\PayoutInterface|null - Объект выплаты ##### Examples: 01-client.php 387 8 Получить информацию о выплате: ```php ``` #### public getPersonalDataInfo() : \YooKassa\Model\PersonalData\PersonalDataInterface|null ```php public getPersonalDataInfo(string $personalDataId) : \YooKassa\Model\PersonalData\PersonalDataInterface|null ``` **Summary** Получить информацию о персональных данных **Description** Запрос позволяет получить информацию о текущем состоянии персональных данных по их уникальному идентификатору. Выдает объект платежа {@link} в актуальном статусе. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | personalDataId | Идентификатор персональных данных | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Model\PersonalData\PersonalDataInterface|null - Объект персональных данных ##### Examples: 01-client.php 415 8 Получить информацию о персональных данных: ```php ``` #### public getReceiptInfo() : \YooKassa\Request\Receipts\ReceiptResponseInterface|null ```php public getReceiptInfo(string $receiptId) : \YooKassa\Request\Receipts\ReceiptResponseInterface|null ``` **Summary** Получить информацию о чеке **Description** Запрос позволяет получить информацию о текущем состоянии чека по его уникальному идентификатору. Выдает объект чека {@link} в актуальном статусе. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | receiptId | Идентификатор чека | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Request\Receipts\ReceiptResponseInterface|null - ##### Examples: 01-client.php 172 8 Получить информацию о чеке: ```php ``` #### public getReceipts() : \YooKassa\Request\Receipts\ReceiptsResponse ```php public getReceipts(\YooKassa\Model\PaymentInterface|\YooKassa\Model\RefundInterface|array|null $filter = null) : \YooKassa\Request\Receipts\ReceiptsResponse ``` **Summary** Получить список чеков магазина **Description** Запрос позволяет получить список чеков, отфильтрованный по заданным критериям. Можно запросить чеки по конкретному платежу, чеки по конкретному возврату или все чеки магазина. В ответ на запрос вернется список чеков с учетом переданных параметров. В списке будет информация о чеках, созданных за последние 3 года. Список будет отсортирован по времени создания чеков в порядке убывания. Если результатов больше, чем задано в `limit`, список будет выводиться фрагментами. В этом случае в ответе на запрос вернется фрагмент списка и параметр `next_cursor` с указателем на следующий фрагмент. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Model\PaymentInterface OR \YooKassa\Model\RefundInterface OR array OR null | filter | | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Request\Receipts\ReceiptsResponse - ##### Examples: 01-client.php 252 21 Получить список чеков магазина с фильтрацией: ```php ``` #### public getRefundInfo() : \YooKassa\Request\Refunds\RefundResponse|null ```php public getRefundInfo(string $refundId) : \YooKassa\Request\Refunds\RefundResponse|null ``` **Summary** Получить информацию о возврате **Description** Запрос позволяет получить информацию о текущем состоянии возврата по его уникальному идентификатору. В ответ на запрос придет объект возврата {@link} в актуальном статусе. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | refundId | Идентификатор возврата | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Request\Refunds\RefundResponse|null - ##### Examples: 01-client.php 182 8 Получить информацию о возврате: ```php ``` #### public getRefunds() : \YooKassa\Request\Refunds\RefundsResponse|null ```php public getRefunds(\YooKassa\Request\Refunds\RefundsRequestInterface|array|null $filter = null) : \YooKassa\Request\Refunds\RefundsResponse|null ``` **Summary** Получить список возвратов платежей **Description** Запрос позволяет получить список возвратов, отфильтрованный по заданным критериям. В ответ на запрос вернется список возвратов с учетом переданных параметров. В списке будет информация о возвратах, созданных за последние 3 года. Список будет отсортирован по времени создания возвратов в порядке убывания. Если результатов больше, чем задано в `limit`, список будет выводиться фрагментами. В этом случае в ответе на запрос вернется фрагмент списка и параметр `next_cursor` с указателем на следующий фрагмент. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Request\Refunds\RefundsRequestInterface OR array OR null | filter | | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Request\Refunds\RefundsResponse|null - ##### Examples: 01-client.php 275 23 Получить список возвратов платежей магазина с фильтрацией: ```php ``` #### public getSbpBanks() : \YooKassa\Request\Payouts\SbpBanksResponse|null ```php public getSbpBanks() : \YooKassa\Request\Payouts\SbpBanksResponse|null ``` **Summary** Получить список участников СБП **Description** С помощью этого запроса вы можете получить актуальный список всех участников СБП. Список нужно вывести получателю выплаты, идентификатор выбранного участника СБП необходимо использовать в запросе на создание выплаты. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Request\Payouts\SbpBanksResponse|null - ##### Examples: 01-client.php 415 7 Получить информацию о персональных данных: ```php ``` #### public getSelfEmployedInfo() : \YooKassa\Model\SelfEmployed\SelfEmployedInterface|null ```php public getSelfEmployedInfo(string $selfEmployedId) : \YooKassa\Model\SelfEmployed\SelfEmployedInterface|null ``` **Summary** Получить информацию о самозанятом **Description** С помощью этого запроса вы можете получить информацию о текущем статусе самозанятого по его уникальному идентификатору. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | selfEmployedId | Идентификатор самозанятого | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | **Returns:** \YooKassa\Model\SelfEmployed\SelfEmployedInterface|null - Объект информации о самозанятом ##### Examples: 01-client.php 441 8 Получить информацию о самозанятом: ```php ``` #### public getWebhooks() : \YooKassa\Request\Webhook\WebhookListResponse|null ```php public getWebhooks() : \YooKassa\Request\Webhook\WebhookListResponse|null ``` **Summary** Список созданных Webhook **Description** Запрос позволяет узнать, какие webhook есть для переданного OAuth-токена. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \YooKassa\Common\Exceptions\AuthorizeException | Ошибка авторизации. Не установлен заголовок. | **Returns:** \YooKassa\Request\Webhook\WebhookListResponse|null - ##### Examples: 01-client.php 192 33 Список созданных Webhook: ```php ``` #### public isNotificationIPTrusted() : bool ```php public isNotificationIPTrusted(string $ip) : bool ``` **Summary** Метод проверяет, находится ли IP адрес среди IP адресов Юkassa, с которых отправляются уведомления **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | ip | IPv4 или IPv6 адрес webhook уведомления | ##### Throws: | Type | Description | | ---- | ----------- | | \Exception | Выбрасывается, если будет передан IP адрес неверного формата | **Returns:** bool - #### public me() : array|null ```php public me(array|string|int|null $filter = null) : array|null ``` **Summary** Информация о магазине **Description** Запрос позволяет получить информацию о магазине для переданного OAuth-токена. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | array OR string OR int OR null | filter | Параметры поиска. В настоящее время доступен только `on_behalf_of` | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \YooKassa\Common\Exceptions\AuthorizeException | Ошибка авторизации. Не установлен заголовок. | **Returns:** array|null - Массив с информацией о магазине ##### Examples: 01-client.php 12 7 Информация о магазине: ```php ``` #### public removeWebhook() : \YooKassa\Model\Webhook\Webhook|null ```php public removeWebhook(string $webhookId, string|null $idempotencyKey = null) : \YooKassa\Model\Webhook\Webhook|null ``` **Summary** Удаление Webhook **Description** Запрос позволяет отписаться от уведомлений о событии для переданного OAuth-токена. Чтобы удалить webhook, вам нужно передать в запросе его идентификатор. **Details:** * Inherited From: [\YooKassa\Client](../classes/YooKassa-Client.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | webhookId | Идентификатор Webhook | | string OR null | idempotencyKey | [Ключ идемпотентности](https://yookassa.ru/developers/using-api/basics?lang=php#idempotence) | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | Требуемое PHP расширение не установлено. | | \Exception | | **Returns:** \YooKassa\Model\Webhook\Webhook|null - ##### Examples: 01-client.php 192 33 Удаление Webhook: ```php ``` #### public setApiClient() : $this ```php public setApiClient(\YooKassa\Client\ApiClientInterface $apiClient) : $this ``` **Summary** Устанавливает CURL клиента для работы с API **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Client\ApiClientInterface | apiClient | | **Returns:** $this - #### public setAuth() : $this ```php public setAuth(string $login, string $password) : $this ``` **Summary** Устанавливает авторизацию по логин/паролю **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | login | | | string | password | | **Returns:** $this - ##### Examples: 01-client.php 7 1 Пример авторизации: ```php ``` #### public setAuthToken() : $this ```php public setAuthToken(string $token) : $this ``` **Summary** Устанавливает авторизацию по Oauth-токену **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | token | | **Returns:** $this - ##### Examples: 01-client.php 9 1 Пример авторизации: ```php ``` #### public setConfig() : mixed ```php public setConfig(array $config) : mixed ``` **Summary** Устанавливает настройки клиента **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | array | config | | **Returns:** mixed - #### public setLogger() : mixed ```php public setLogger(null|callable|object|\Psr\Log\LoggerInterface $value) : mixed ``` **Summary** Устанавливает логгер приложения **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | null OR callable OR object OR \Psr\Log\LoggerInterface | value | Инстанс логгера | **Returns:** mixed - #### public setMaxRequestAttempts() : $this ```php public setMaxRequestAttempts(int $attempts) : $this ``` **Summary** Установка значения количества попыток повторных запросов при статусе 202 **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | int | attempts | | **Returns:** $this - #### public setRetryTimeout() : $this ```php public setRetryTimeout(int $timeout) : $this ``` **Summary** Установка значения задержки между повторными запросами **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | int | timeout | | **Returns:** $this - #### protected decodeData() : array ```php protected decodeData(\YooKassa\Common\ResponseObject $response) : array ``` **Summary** Декодирует JSON строку в массив данных **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Common\ResponseObject | response | Объект ответа на запрос к API | **Returns:** array - Массив данных #### protected delay() : mixed ```php protected delay(\YooKassa\Common\ResponseObject $response) : mixed ``` **Summary** Задержка между повторными запросами **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Common\ResponseObject | response | Объект ответа на запрос к API | **Returns:** mixed - #### protected encodeData() : string ```php protected encodeData(array $serializedData) : string ``` **Summary** Кодирует массив данных в JSON строку **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | array | serializedData | Массив данных для кодировки | ##### Throws: | Type | Description | | ---- | ----------- | | \Exception | Выбрасывается, если не удалось конвертировать данные в строку JSON | **Returns:** string - Строка JSON #### protected execute() : mixed|\YooKassa\Common\ResponseObject ```php protected execute(string $path, string $method, array $queryParams, string|null $httpBody = null, array $headers = array()) : mixed|\YooKassa\Common\ResponseObject ``` **Summary** Выполнение запроса и обработка 202 статуса **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | string | path | URL запроса | | string | method | HTTP метод | | array | queryParams | Массив GET параметров запроса | | string OR null | httpBody | Тело запроса | | array | headers | Массив заголовков запроса | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | | | \YooKassa\Common\Exceptions\AuthorizeException | | | \YooKassa\Common\Exceptions\ApiConnectionException | | | \YooKassa\Common\Exceptions\ExtensionNotFoundException | | **Returns:** mixed|\YooKassa\Common\ResponseObject - #### protected handleError() : mixed ```php protected handleError(\YooKassa\Common\ResponseObject $response) : mixed ``` **Summary** Выбрасывает исключение по коду ошибки **Details:** * Inherited From: [\YooKassa\Client\BaseClient](../classes/YooKassa-Client-BaseClient.md) ##### Parameters: | Type | Name | Description | | ---- | ---- | ----------- | | \YooKassa\Common\ResponseObject | response | | ##### Throws: | Type | Description | | ---- | ----------- | | \YooKassa\Common\Exceptions\ApiException | Неожиданный код ошибки. | | \YooKassa\Common\Exceptions\BadApiRequestException | Неправильный запрос. Чаще всего этот статус выдается из-за нарушения правил взаимодействия с API. | | \YooKassa\Common\Exceptions\ForbiddenException | Секретный ключ или OAuth-токен верный, но не хватает прав для совершения операции. | | \YooKassa\Common\Exceptions\InternalServerError | Технические неполадки на стороне ЮKassa. Результат обработки запроса неизвестен. Повторите запрос позднее с тем же ключом идемпотентности. | | \YooKassa\Common\Exceptions\NotFoundException | Ресурс не найден. | | \YooKassa\Common\Exceptions\ResponseProcessingException | Запрос был принят на обработку, но она не завершена. | | \YooKassa\Common\Exceptions\TooManyRequestsException | Превышен лимит запросов в единицу времени. Попробуйте снизить интенсивность запросов. | | \YooKassa\Common\Exceptions\UnauthorizedException | Неверное имя пользователя или пароль или невалидный OAuth-токен при аутентификации. | | \YooKassa\Common\Exceptions\AuthorizeException | Ошибка авторизации. Не установлен заголовок. | **Returns:** mixed - --- ### Top Namespaces * [\YooKassa](../namespaces/yookassa.md) --- ### Reports * [Errors - 0](../reports/errors.md) * [Markers - 1](../reports/markers.md) * [Deprecated - 25](../reports/deprecated.md) --- This document was automatically generated from source code comments on 2023-04-06 using [phpDocumentor](http://www.phpdoc.org/) © 2023 YooMoney