В объект выплаты добавлен параметр succeeded_at (время перехода выплаты в статус succeeded)

This commit is contained in:
Антон Н. Николаев
2025-07-31 16:17:04 +03:00
parent 8fc1f07bcb
commit b5e17ed221
469 changed files with 1109 additions and 489 deletions
+1 -1
View File
@@ -130,7 +130,7 @@ class Client extends BaseClient
/**
* Текущая версия библиотеки.
*/
public const SDK_VERSION = '3.9.0';
public const SDK_VERSION = '3.9.1';
/**
* Получить список платежей магазина.
+38 -3
View File
@@ -53,6 +53,8 @@ use YooKassa\Validator\Constraints as Assert;
* @property string $description Описание транзакции
* @property DateTime $createdAt Время создания заказа
* @property DateTime $created_at Время создания заказа
* @property DateTime $succeededAt Время успешного проведения выплаты
* @property DateTime $succeeded_at Время успешного проведения выплаты
* @property PayoutDealInfo $deal Сделка, в рамках которой нужно провести выплату
* @property PayoutSelfEmployed $self_employed Данные самозанятого, который получит выплату
* @property PayoutSelfEmployed $selfEmployed Данные самозанятого, который получит выплату
@@ -132,6 +134,16 @@ class Payout extends AbstractObject implements PayoutInterface
#[Assert\Type('DateTime')]
protected ?DateTime $_created_at = null;
/**
* Время успешного проведения выплаты. Пример: ~`2017-11-03T11:52:42.312Z`
* Обязательный параметр для выплат в статусе ~`succeeded`
*
* @var DateTime|null
*/
#[Assert\DateTime(format: YOOKASSA_DATE)]
#[Assert\Type('DateTime')]
protected ?DateTime $_succeeded_at = null;
/**
* Сделка, в рамках которой нужно провести выплату. Присутствует, если вы проводите Безопасную сделку
*
@@ -301,9 +313,9 @@ class Payout extends AbstractObject implements PayoutInterface
}
/**
* Возвращает время создания заказа.
* Возвращает время создания выплаты.
*
* @return DateTime|null Время создания заказа
* @return DateTime|null Время создания выплаты
*/
public function getCreatedAt(): ?DateTime
{
@@ -311,7 +323,7 @@ class Payout extends AbstractObject implements PayoutInterface
}
/**
* Устанавливает время создания заказа.
* Устанавливает время создания выплаты.
*
* @param DateTime|string|null $created_at Время создания выплаты. Пример: ~`2017-11-03T11:52:31.827Z`
*
@@ -323,6 +335,29 @@ class Payout extends AbstractObject implements PayoutInterface
return $this;
}
/**
* Возвращает время успешного проведения выплаты.
*
* @return DateTime|null Время успешного проведения выплаты
*/
public function getSucceededAt(): ?DateTime
{
return $this->_succeeded_at;
}
/**
* Устанавливает время успешного проведения выплаты.
*
* @param DateTime|string|null $succeeded_at Время успешного проведения выплаты. Указывается по [UTC](https://ru.wikipedia.org/wiki/Всемирное_координированное_время) и передается в формате [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). Пример: ~`2017-11-03T11:52:42.312Z` Обязательный параметр для выплат в статусе ~`succeeded`.
*
* @return self
*/
public function setSucceededAt(DateTime|string|null $succeeded_at = null): self
{
$this->_succeeded_at = $this->validatePropertyValue('_succeeded_at', $succeeded_at);
return $this;
}
/**
* Возвращает метаданные выплаты установленные мерчантом
*
+10 -1
View File
@@ -48,6 +48,8 @@ use YooKassa\Model\Payment\PaymentMethod\AbstractPaymentMethod;
* @property string $description Описание транзакции
* @property DateTime $createdAt Время создания заказа
* @property DateTime $created_at Время создания заказа
* @property DateTime $succeededAt Время успешного проведения выплаты
* @property DateTime $succeeded_at Время успешного проведения выплаты
* @property PayoutDealInfo $deal Сделка, в рамках которой нужно провести выплату
* @property CancellationDetailsInterface $cancellationDetails Комментарий к отмене выплаты
* @property CancellationDetailsInterface $cancellation_details Комментарий к отмене выплаты
@@ -92,12 +94,19 @@ interface PayoutInterface
public function getDescription(): ?string;
/**
* Возвращает время создания сделки.
* Возвращает время создания выплаты.
*
* @return DateTime|null Время создания сделки
*/
public function getCreatedAt(): ?DateTime;
/**
* Возвращает время успешного проведения выплаты.
*
* @return DateTime|null Время создания выплаты
*/
public function getSucceededAt(): ?DateTime;
/**
* Возвращает сделку, в рамках которой нужно провести выплату.
*