mirror of
https://git.yoomoney.ru/scm/sdk/yookassa-sdk-php.git
synced 2026-08-18 06:00:49 +00:00
Антон Н. Николаев
2db9951ff6
Информация про чеки самозанятых в платежах и возвратах удалена - больше не поддерживаем сервисы для самозанятых Добавлена возможность выставления счета по смс и email Добавлена поддержка работы со списками выплат Обновлен Copyright
388 lines
16 KiB
PHP
388 lines
16 KiB
PHP
<?php
|
||
|
||
/*
|
||
* The MIT License
|
||
*
|
||
* Copyright (c) 2026 "YooMoney", NBСO LLC
|
||
*
|
||
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
||
* of this software and associated documentation files (the "Software"), to deal
|
||
* in the Software without restriction, including without limitation the rights
|
||
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||
* copies of the Software, and to permit persons to whom the Software is
|
||
* furnished to do so, subject to the following conditions:
|
||
*
|
||
* The above copyright notice and this permission notice shall be included in
|
||
* all copies or substantial portions of the Software.
|
||
*
|
||
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
||
* THE SOFTWARE.
|
||
*/
|
||
|
||
namespace YooKassa\Model\Settings;
|
||
|
||
use YooKassa\Common\AbstractObject;
|
||
use YooKassa\Model\AmountInterface;
|
||
use YooKassa\Model\MonetaryAmount;
|
||
use YooKassa\Validator\Constraints as Assert;
|
||
|
||
/**
|
||
* Класс, представляющий модель Me.
|
||
*
|
||
* Объект настроек магазина или шлюза (Me) — актуальная информация о настройках магазина или шлюза.
|
||
*
|
||
* @category Class
|
||
* @package YooKassa\Model
|
||
* @author cms@yoomoney.ru
|
||
* @link https://yookassa.ru/developers/api
|
||
*
|
||
* @property string $accountId Идентификатор магазина или шлюза.
|
||
* @property string $account_id Идентификатор магазина или шлюза.
|
||
* @property string $status Статус магазина или шлюза.
|
||
* @property bool $test Это тестовый магазин или шлюз.
|
||
* @property FiscalizationData $fiscalization Настройки магазина для [отправки чеков в налоговую](https://yookassa.ru/developers/payment-acceptance/receipts/basics).
|
||
* @property bool $fiscalizationEnabled Устаревший параметр, который раньше использовался для определения настроек отправки чеков в налоговую. Сохранен для поддержки обратной совместимости, в новых версиях API может быть удален. Используйте объект ~`fiscalization`, чтобы определить, какие у магазина настройки отправки чеков.
|
||
* @property bool $fiscalization_enabled Устаревший параметр, который раньше использовался для определения настроек отправки чеков в налоговую. Сохранен для поддержки обратной совместимости, в новых версиях API может быть удален. Используйте объект ~`fiscalization`, чтобы определить, какие у магазина настройки отправки чеков.
|
||
* @property string[]|array $paymentMethods Список [способов оплаты](https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all), доступных магазину. Присутствует, если вы запрашивали настройки магазина.
|
||
* @property string[]|array $payment_methods Список [способов оплаты](https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all), доступных магазину. Присутствует, если вы запрашивали настройки магазина.
|
||
* @property string|null $itn ИНН магазина (10 или 12 цифр). Присутствует, если вы запрашивали настройки магазина.
|
||
* @property string[]|array $payoutMethods Список способов получения выплат, доступных шлюзу. Возможные значения: `bank_card` — выплаты на банковские карты; `yoo_money` — выплаты на кошельки ЮMoney; `sbp` — выплаты через СБП. Присутствует, если вы запрашивали настройки шлюза.
|
||
* @property string[]|array $payout_methods Список способов получения выплат, доступных шлюзу. Возможные значения: `bank_card` — выплаты на банковские карты; `yoo_money` — выплаты на кошельки ЮMoney; `sbp` — выплаты через СБП. Присутствует, если вы запрашивали настройки шлюза.
|
||
* @property string|null $name Название шлюза, которое отображается в личном кабинете ЮKassa. Присутствует, если вы запрашивали настройки шлюза.
|
||
* @property AmountInterface|null $payoutBalance Баланс вашего шлюза. Присутствует, если вы запрашивали настройки шлюза.
|
||
* @property AmountInterface|null $payout_balance Баланс вашего шлюза. Присутствует, если вы запрашивали настройки шлюза.
|
||
*/
|
||
class Me extends AbstractObject
|
||
{
|
||
/** Подключен к ЮKassa, может проводить платежи или выплаты */
|
||
public const STATUS_ENABLED = 'enabled';
|
||
/** Не может проводить платежи или выплаты (еще не подключен, закрыт или временно не работает) */
|
||
public const STATUS_DISABLED = 'disabled';
|
||
|
||
/**
|
||
* Идентификатор магазина или шлюза.
|
||
*
|
||
* @var string|null
|
||
*/
|
||
#[Assert\NotBlank]
|
||
#[Assert\Type('string')]
|
||
private ?string $_account_id = null;
|
||
|
||
/**
|
||
* Статус магазина или шлюза. Возможные значения: `enabled` — подключен к ЮKassa, может проводить платежи или выплаты; `disabled` — не может проводить платежи или выплаты (еще не подключен, закрыт или временно не работает).
|
||
*
|
||
* @var string|null
|
||
*/
|
||
#[Assert\NotBlank]
|
||
#[Assert\Choice(choices: [self::STATUS_ENABLED, self::STATUS_DISABLED])]
|
||
#[Assert\Type('string')]
|
||
private ?string $_status = null;
|
||
|
||
/**
|
||
* Это тестовый магазин или шлюз.
|
||
*
|
||
* @var bool|null
|
||
*/
|
||
#[Assert\NotNull]
|
||
#[Assert\Type('bool')]
|
||
private ?bool $_test = null;
|
||
|
||
/**
|
||
* Настройки магазина для [отправки чеков в налоговую](https://yookassa.ru/developers/payment-acceptance/receipts/basics).
|
||
*
|
||
* @var FiscalizationData|null
|
||
*/
|
||
#[Assert\Type(FiscalizationData::class)]
|
||
private ?FiscalizationData $_fiscalization = null;
|
||
|
||
/**
|
||
* Устаревший параметр, который раньше использовался для определения настроек отправки чеков в налоговую. Сохранен для поддержки обратной совместимости, в новых версиях API может быть удален. Используйте объект ~`fiscalization`, чтобы определить, какие у магазина настройки отправки чеков.
|
||
*
|
||
* @deprecated Устарел. Вместо него используйте объект `fiscalization`
|
||
* @var bool|null
|
||
*/
|
||
#[Assert\Type('bool')]
|
||
private ?bool $_fiscalization_enabled = null;
|
||
|
||
/**
|
||
* Список [способов оплаты](https://yookassa.ru/developers/payment-acceptance/getting-started/payment-methods#all), доступных магазину. Присутствует, если вы запрашивали настройки магазина.
|
||
*
|
||
* @var string[]|array|null
|
||
*/
|
||
#[Assert\AllType('string')]
|
||
#[Assert\Type('array')]
|
||
private ?array $_payment_methods = null;
|
||
|
||
/**
|
||
* ИНН магазина (10 или 12 цифр). Присутствует, если вы запрашивали настройки магазина.
|
||
*
|
||
* @var string|null
|
||
*/
|
||
#[Assert\Type('string')]
|
||
private ?string $_itn = null;
|
||
|
||
/**
|
||
* Список способов получения выплат, доступных шлюзу. Возможные значения: `bank_card` — выплаты на банковские карты; `yoo_money` — выплаты на кошельки ЮMoney; `sbp` — выплаты через СБП. Присутствует, если вы запрашивали настройки шлюза.
|
||
*
|
||
* @var string[]|array|null
|
||
*/
|
||
#[Assert\AllType('string')]
|
||
#[Assert\Type('array')]
|
||
private ?array $_payout_methods = null;
|
||
|
||
/**
|
||
* Название шлюза, которое отображается в личном кабинете ЮKassa. Присутствует, если вы запрашивали настройки шлюза.
|
||
*
|
||
* @var string|null
|
||
*/
|
||
#[Assert\Type('string')]
|
||
private ?string $_name = null;
|
||
|
||
/**
|
||
* Баланс вашего шлюза. Присутствует, если вы запрашивали настройки шлюза.
|
||
*
|
||
* @var AmountInterface|null
|
||
*/
|
||
#[Assert\Type(MonetaryAmount::class)]
|
||
private ?AmountInterface $_payout_balance = null;
|
||
|
||
/**
|
||
* Возвращает идентификатор магазина или шлюза.
|
||
*
|
||
* @return string|null
|
||
*/
|
||
public function getAccountId(): ?string
|
||
{
|
||
return $this->_account_id;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает идентификатор магазина или шлюза.
|
||
*
|
||
* @param string|int|null $account_id
|
||
*
|
||
* @return self
|
||
*/
|
||
public function setAccountId(mixed $account_id = null): self
|
||
{
|
||
$this->_account_id = $this->validatePropertyValue('_account_id', (string)$account_id);
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает статус магазина или шлюза.
|
||
*
|
||
* @return string|null
|
||
*/
|
||
public function getStatus(): ?string
|
||
{
|
||
return $this->_status;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает статус магазина или шлюза.
|
||
*
|
||
* @param string|null $status Статус магазина или шлюза.
|
||
*
|
||
* @return self
|
||
*/
|
||
public function setStatus(?string $status = null): self
|
||
{
|
||
$this->_status = $this->validatePropertyValue('_status', $status);
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает тестовый магазин или шлюз.
|
||
*
|
||
* @return bool|null
|
||
*/
|
||
public function getTest(): ?bool
|
||
{
|
||
return $this->_test;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает тестовый магазин или шлюз.
|
||
*
|
||
* @param bool|null $test Это тестовый магазин или шлюз.
|
||
*
|
||
* @return self
|
||
*/
|
||
public function setTest(mixed $test = null): self
|
||
{
|
||
$this->_test = $this->validatePropertyValue('_test', $test);
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает настройки магазина для отправки чеков в налоговую.
|
||
*
|
||
* @return FiscalizationData|null
|
||
*/
|
||
public function getFiscalization(): ?FiscalizationData
|
||
{
|
||
return $this->_fiscalization;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает настройки магазина для отправки чеков в налоговую.
|
||
*
|
||
* @param FiscalizationData|array|null $fiscalization Настройки магазина для отправки чеков в налоговую.
|
||
*
|
||
* @return self
|
||
*/
|
||
public function setFiscalization(mixed $fiscalization = null): self
|
||
{
|
||
$this->_fiscalization = $this->validatePropertyValue('_fiscalization', $fiscalization);
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает признак включенной фискализации.
|
||
*
|
||
* @deprecated Устарел.
|
||
* @return bool|null
|
||
*/
|
||
public function getFiscalizationEnabled(): ?bool
|
||
{
|
||
return $this->_fiscalization_enabled;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает признак включенной фискализации.
|
||
*
|
||
* @deprecated Устарел.
|
||
* @param bool|null $fiscalization_enabled Признак включенной фискализации.
|
||
*
|
||
* @return self
|
||
*/
|
||
public function setFiscalizationEnabled(mixed $fiscalization_enabled = null): self
|
||
{
|
||
$this->_fiscalization_enabled = $this->validatePropertyValue('_fiscalization_enabled', $fiscalization_enabled);
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает список способов оплаты, доступных магазину.
|
||
*
|
||
* @return string[]|array|null
|
||
*/
|
||
public function getPaymentMethods(): ?array
|
||
{
|
||
return $this->_payment_methods;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает список способов оплаты, доступных магазину.
|
||
*
|
||
* @param string[]|array|null $payment_methods Список способов оплаты, доступных магазину.
|
||
*
|
||
* @return self
|
||
*/
|
||
public function setPaymentMethods(mixed $payment_methods = null): self
|
||
{
|
||
$this->_payment_methods = $this->validatePropertyValue('_payment_methods', $payment_methods);
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает ИНН магазина.
|
||
*
|
||
* @return string|null
|
||
*/
|
||
public function getItn(): ?string
|
||
{
|
||
return $this->_itn;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает ИНН магазина.
|
||
*
|
||
* @param string|null $itn ИНН магазина (10 или 12 цифр).
|
||
*
|
||
* @return self
|
||
*/
|
||
public function setItn(?string $itn = null): self
|
||
{
|
||
$this->_itn = $this->validatePropertyValue('_itn', $itn);
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает список способов получения выплат.
|
||
*
|
||
* @return string[]|null
|
||
*/
|
||
public function getPayoutMethods(): ?array
|
||
{
|
||
return $this->_payout_methods;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает список способов получения выплат.
|
||
*
|
||
* @param string[]|array|null $payout_methods Список способов получения выплат, доступных шлюзу.
|
||
*
|
||
* @return self
|
||
*/
|
||
public function setPayoutMethods(mixed $payout_methods = null): self
|
||
{
|
||
$this->_payout_methods = $this->validatePropertyValue('_payout_methods', $payout_methods);
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает название шлюза.
|
||
*
|
||
* @return string|null
|
||
*/
|
||
public function getName(): ?string
|
||
{
|
||
return $this->_name;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает название шлюза.
|
||
*
|
||
* @param string|null $name Название шлюза, которое отображается в личном кабинете ЮKassa.
|
||
*
|
||
* @return self
|
||
*/
|
||
public function setName(?string $name = null): self
|
||
{
|
||
$this->_name = $this->validatePropertyValue('_name', $name);
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* Возвращает баланс вашего шлюза.
|
||
*
|
||
* @return AmountInterface|null
|
||
*/
|
||
public function getPayoutBalance(): ?AmountInterface
|
||
{
|
||
return $this->_payout_balance;
|
||
}
|
||
|
||
/**
|
||
* Устанавливает Баланс вашего шлюза.
|
||
*
|
||
* @param AmountInterface|array|null $payout_balance Баланс вашего шлюза. Присутствует, если вы запрашивали настройки шлюза.
|
||
*
|
||
* @return self
|
||
*/
|
||
public function setPayoutBalance(mixed $payout_balance = null): self
|
||
{
|
||
$this->_payout_balance = $this->validatePropertyValue('_payout_balance', $payout_balance);
|
||
return $this;
|
||
}
|
||
|
||
}
|
||
|