👁 查看:SubscriptionAction.php
路径:/home/forge/woocommerce-square/vendor/square/square/src/Models/SubscriptionAction.php
大小:6.23 KB · 修改:2025-12-23 20:26:26 · 权限:0644 · 可写
<?php
declare(strict_types=1);
namespace Square\Models;
use stdClass;
/**
* Represents an action as a pending change to a subscription.
*/
class SubscriptionAction implements \JsonSerializable
{
/**
* @var string|null
*/
private $id;
/**
* @var string|null
*/
private $type;
/**
* @var array
*/
private $effectiveDate = [];
/**
* @var array
*/
private $monthlyBillingAnchorDate = [];
/**
* @var array
*/
private $phases = [];
/**
* @var array
*/
private $newPlanVariationId = [];
/**
* Returns Id.
* The ID of an action scoped to a subscription.
*/
public function getId(): ?string
{
return $this->id;
}
/**
* Sets Id.
* The ID of an action scoped to a subscription.
*
* @maps id
*/
public function setId(?string $id): void
{
$this->id = $id;
}
/**
* Returns Type.
* Supported types of an action as a pending change to a subscription.
*/
public function getType(): ?string
{
return $this->type;
}
/**
* Sets Type.
* Supported types of an action as a pending change to a subscription.
*
* @maps type
*/
public function setType(?string $type): void
{
$this->type = $type;
}
/**
* Returns Effective Date.
* The `YYYY-MM-DD`-formatted date when the action occurs on the subscription.
*/
public function getEffectiveDate(): ?string
{
if (count($this->effectiveDate) == 0) {
return null;
}
return $this->effectiveDate['value'];
}
/**
* Sets Effective Date.
* The `YYYY-MM-DD`-formatted date when the action occurs on the subscription.
*
* @maps effective_date
*/
public function setEffectiveDate(?string $effectiveDate): void
{
$this->effectiveDate['value'] = $effectiveDate;
}
/**
* Unsets Effective Date.
* The `YYYY-MM-DD`-formatted date when the action occurs on the subscription.
*/
public function unsetEffectiveDate(): void
{
$this->effectiveDate = [];
}
/**
* Returns Monthly Billing Anchor Date.
* The new billing anchor day value, for a `CHANGE_BILLING_ANCHOR_DATE` action.
*/
public function getMonthlyBillingAnchorDate(): ?int
{
if (count($this->monthlyBillingAnchorDate) == 0) {
return null;
}
return $this->monthlyBillingAnchorDate['value'];
}
/**
* Sets Monthly Billing Anchor Date.
* The new billing anchor day value, for a `CHANGE_BILLING_ANCHOR_DATE` action.
*
* @maps monthly_billing_anchor_date
*/
public function setMonthlyBillingAnchorDate(?int $monthlyBillingAnchorDate): void
{
$this->monthlyBillingAnchorDate['value'] = $monthlyBillingAnchorDate;
}
/**
* Unsets Monthly Billing Anchor Date.
* The new billing anchor day value, for a `CHANGE_BILLING_ANCHOR_DATE` action.
*/
public function unsetMonthlyBillingAnchorDate(): void
{
$this->monthlyBillingAnchorDate = [];
}
/**
* Returns Phases.
* A list of Phases, to pass phase-specific information used in the swap.
*
* @return Phase[]|null
*/
public function getPhases(): ?array
{
if (count($this->phases) == 0) {
return null;
}
return $this->phases['value'];
}
/**
* Sets Phases.
* A list of Phases, to pass phase-specific information used in the swap.
*
* @maps phases
*
* @param Phase[]|null $phases
*/
public function setPhases(?array $phases): void
{
$this->phases['value'] = $phases;
}
/**
* Unsets Phases.
* A list of Phases, to pass phase-specific information used in the swap.
*/
public function unsetPhases(): void
{
$this->phases = [];
}
/**
* Returns New Plan Variation Id.
* The target subscription plan variation that a subscription switches to, for a `SWAP_PLAN` action.
*/
public function getNewPlanVariationId(): ?string
{
if (count($this->newPlanVariationId) == 0) {
return null;
}
return $this->newPlanVariationId['value'];
}
/**
* Sets New Plan Variation Id.
* The target subscription plan variation that a subscription switches to, for a `SWAP_PLAN` action.
*
* @maps new_plan_variation_id
*/
public function setNewPlanVariationId(?string $newPlanVariationId): void
{
$this->newPlanVariationId['value'] = $newPlanVariationId;
}
/**
* Unsets New Plan Variation Id.
* The target subscription plan variation that a subscription switches to, for a `SWAP_PLAN` action.
*/
public function unsetNewPlanVariationId(): void
{
$this->newPlanVariationId = [];
}
/**
* Encode this object to JSON
*
* @param bool $asArrayWhenEmpty Whether to serialize this model as an array whenever no fields
* are set. (default: false)
*
* @return array|stdClass
*/
#[\ReturnTypeWillChange] // @phan-suppress-current-line PhanUndeclaredClassAttribute for (php < 8.1)
public function jsonSerialize(bool $asArrayWhenEmpty = false)
{
$json = [];
if (isset($this->id)) {
$json['id'] = $this->id;
}
if (isset($this->type)) {
$json['type'] = $this->type;
}
if (!empty($this->effectiveDate)) {
$json['effective_date'] = $this->effectiveDate['value'];
}
if (!empty($this->monthlyBillingAnchorDate)) {
$json['monthly_billing_anchor_date'] = $this->monthlyBillingAnchorDate['value'];
}
if (!empty($this->phases)) {
$json['phases'] = $this->phases['value'];
}
if (!empty($this->newPlanVariationId)) {
$json['new_plan_variation_id'] = $this->newPlanVariationId['value'];
}
$json = array_filter($json, function ($val) {
return $val !== null;
});
return (!$asArrayWhenEmpty && empty($json)) ? new stdClass() : $json;
}
}