Create New Item
Item Type
File
Folder
Item Name
Search file in folder and subfolders...
Are you sure want to rename?
forbidals
/
wp-content
/
plugins
/
wpforms-lite
/
vendor_prefixed
/
square
/
square
/
src
/
Models
:
GiftCardActivity.php
Advanced Search
Upload
New Item
Settings
Back
Back Up
Advanced Editor
Save
<?php declare (strict_types=1); namespace WPForms\Vendor\Square\Models; use stdClass; /** * Represents an action performed on a [gift card]($m/GiftCard) that affects its state or balance. * A gift card activity contains information about a specific activity type. For example, a `REDEEM` * activity * includes a `redeem_activity_details` field that contains information about the redemption. */ class GiftCardActivity implements \JsonSerializable { /** * @var string|null */ private $id; /** * @var string */ private $type; /** * @var string */ private $locationId; /** * @var string|null */ private $createdAt; /** * @var array */ private $giftCardId = []; /** * @var array */ private $giftCardGan = []; /** * @var Money|null */ private $giftCardBalanceMoney; /** * @var GiftCardActivityLoad|null */ private $loadActivityDetails; /** * @var GiftCardActivityActivate|null */ private $activateActivityDetails; /** * @var GiftCardActivityRedeem|null */ private $redeemActivityDetails; /** * @var GiftCardActivityClearBalance|null */ private $clearBalanceActivityDetails; /** * @var GiftCardActivityDeactivate|null */ private $deactivateActivityDetails; /** * @var GiftCardActivityAdjustIncrement|null */ private $adjustIncrementActivityDetails; /** * @var GiftCardActivityAdjustDecrement|null */ private $adjustDecrementActivityDetails; /** * @var GiftCardActivityRefund|null */ private $refundActivityDetails; /** * @var GiftCardActivityUnlinkedActivityRefund|null */ private $unlinkedActivityRefundActivityDetails; /** * @var GiftCardActivityImport|null */ private $importActivityDetails; /** * @var GiftCardActivityBlock|null */ private $blockActivityDetails; /** * @var GiftCardActivityUnblock|null */ private $unblockActivityDetails; /** * @var GiftCardActivityImportReversal|null */ private $importReversalActivityDetails; /** * @var GiftCardActivityTransferBalanceTo|null */ private $transferBalanceToActivityDetails; /** * @var GiftCardActivityTransferBalanceFrom|null */ private $transferBalanceFromActivityDetails; /** * @param string $type * @param string $locationId */ public function __construct(string $type, string $locationId) { $this->type = $type; $this->locationId = $locationId; } /** * Returns Id. * The Square-assigned ID of the gift card activity. */ public function getId() : ?string { return $this->id; } /** * Sets Id. * The Square-assigned ID of the gift card activity. * * @maps id */ public function setId(?string $id) : void { $this->id = $id; } /** * Returns Type. * Indicates the type of [gift card activity]($m/GiftCardActivity). */ public function getType() : string { return $this->type; } /** * Sets Type. * Indicates the type of [gift card activity]($m/GiftCardActivity). * * @required * @maps type */ public function setType(string $type) : void { $this->type = $type; } /** * Returns Location Id. * The ID of the [business location](entity:Location) where the activity occurred. */ public function getLocationId() : string { return $this->locationId; } /** * Sets Location Id. * The ID of the [business location](entity:Location) where the activity occurred. * * @required * @maps location_id */ public function setLocationId(string $locationId) : void { $this->locationId = $locationId; } /** * Returns Created At. * The timestamp when the gift card activity was created, in RFC 3339 format. */ public function getCreatedAt() : ?string { return $this->createdAt; } /** * Sets Created At. * The timestamp when the gift card activity was created, in RFC 3339 format. * * @maps created_at */ public function setCreatedAt(?string $createdAt) : void { $this->createdAt = $createdAt; } /** * Returns Gift Card Id. * The gift card ID. When creating a gift card activity, `gift_card_id` is not required if * `gift_card_gan` is specified. */ public function getGiftCardId() : ?string { if (\count($this->giftCardId) == 0) { return null; } return $this->giftCardId['value']; } /** * Sets Gift Card Id. * The gift card ID. When creating a gift card activity, `gift_card_id` is not required if * `gift_card_gan` is specified. * * @maps gift_card_id */ public function setGiftCardId(?string $giftCardId) : void { $this->giftCardId['value'] = $giftCardId; } /** * Unsets Gift Card Id. * The gift card ID. When creating a gift card activity, `gift_card_id` is not required if * `gift_card_gan` is specified. */ public function unsetGiftCardId() : void { $this->giftCardId = []; } /** * Returns Gift Card Gan. * The gift card account number (GAN). When creating a gift card activity, `gift_card_gan` * is not required if `gift_card_id` is specified. */ public function getGiftCardGan() : ?string { if (\count($this->giftCardGan) == 0) { return null; } return $this->giftCardGan['value']; } /** * Sets Gift Card Gan. * The gift card account number (GAN). When creating a gift card activity, `gift_card_gan` * is not required if `gift_card_id` is specified. * * @maps gift_card_gan */ public function setGiftCardGan(?string $giftCardGan) : void { $this->giftCardGan['value'] = $giftCardGan; } /** * Unsets Gift Card Gan. * The gift card account number (GAN). When creating a gift card activity, `gift_card_gan` * is not required if `gift_card_id` is specified. */ public function unsetGiftCardGan() : void { $this->giftCardGan = []; } /** * Returns Gift Card Balance Money. * Represents an amount of money. `Money` fields can be signed or unsigned. * Fields that do not explicitly define whether they are signed or unsigned are * considered unsigned and can only hold positive amounts. For signed fields, the * sign of the value indicates the purpose of the money transfer. See * [Working with Monetary Amounts](https://developer.squareup.com/docs/build-basics/working-with- * monetary-amounts) * for more information. */ public function getGiftCardBalanceMoney() : ?Money { return $this->giftCardBalanceMoney; } /** * Sets Gift Card Balance Money. * Represents an amount of money. `Money` fields can be signed or unsigned. * Fields that do not explicitly define whether they are signed or unsigned are * considered unsigned and can only hold positive amounts. For signed fields, the * sign of the value indicates the purpose of the money transfer. See * [Working with Monetary Amounts](https://developer.squareup.com/docs/build-basics/working-with- * monetary-amounts) * for more information. * * @maps gift_card_balance_money */ public function setGiftCardBalanceMoney(?Money $giftCardBalanceMoney) : void { $this->giftCardBalanceMoney = $giftCardBalanceMoney; } /** * Returns Load Activity Details. * Represents details about a `LOAD` [gift card activity type]($m/GiftCardActivityType). */ public function getLoadActivityDetails() : ?GiftCardActivityLoad { return $this->loadActivityDetails; } /** * Sets Load Activity Details. * Represents details about a `LOAD` [gift card activity type]($m/GiftCardActivityType). * * @maps load_activity_details */ public function setLoadActivityDetails(?GiftCardActivityLoad $loadActivityDetails) : void { $this->loadActivityDetails = $loadActivityDetails; } /** * Returns Activate Activity Details. * Represents details about an `ACTIVATE` [gift card activity type]($m/GiftCardActivityType). */ public function getActivateActivityDetails() : ?GiftCardActivityActivate { return $this->activateActivityDetails; } /** * Sets Activate Activity Details. * Represents details about an `ACTIVATE` [gift card activity type]($m/GiftCardActivityType). * * @maps activate_activity_details */ public function setActivateActivityDetails(?GiftCardActivityActivate $activateActivityDetails) : void { $this->activateActivityDetails = $activateActivityDetails; } /** * Returns Redeem Activity Details. * Represents details about a `REDEEM` [gift card activity type]($m/GiftCardActivityType). */ public function getRedeemActivityDetails() : ?GiftCardActivityRedeem { return $this->redeemActivityDetails; } /** * Sets Redeem Activity Details. * Represents details about a `REDEEM` [gift card activity type]($m/GiftCardActivityType). * * @maps redeem_activity_details */ public function setRedeemActivityDetails(?GiftCardActivityRedeem $redeemActivityDetails) : void { $this->redeemActivityDetails = $redeemActivityDetails; } /** * Returns Clear Balance Activity Details. * Represents details about a `CLEAR_BALANCE` [gift card activity type]($m/GiftCardActivityType). */ public function getClearBalanceActivityDetails() : ?GiftCardActivityClearBalance { return $this->clearBalanceActivityDetails; } /** * Sets Clear Balance Activity Details. * Represents details about a `CLEAR_BALANCE` [gift card activity type]($m/GiftCardActivityType). * * @maps clear_balance_activity_details */ public function setClearBalanceActivityDetails(?GiftCardActivityClearBalance $clearBalanceActivityDetails) : void { $this->clearBalanceActivityDetails = $clearBalanceActivityDetails; } /** * Returns Deactivate Activity Details. * Represents details about a `DEACTIVATE` [gift card activity type]($m/GiftCardActivityType). */ public function getDeactivateActivityDetails() : ?GiftCardActivityDeactivate { return $this->deactivateActivityDetails; } /** * Sets Deactivate Activity Details. * Represents details about a `DEACTIVATE` [gift card activity type]($m/GiftCardActivityType). * * @maps deactivate_activity_details */ public function setDeactivateActivityDetails(?GiftCardActivityDeactivate $deactivateActivityDetails) : void { $this->deactivateActivityDetails = $deactivateActivityDetails; } /** * Returns Adjust Increment Activity Details. * Represents details about an `ADJUST_INCREMENT` [gift card activity type]($m/GiftCardActivityType). */ public function getAdjustIncrementActivityDetails() : ?GiftCardActivityAdjustIncrement { return $this->adjustIncrementActivityDetails; } /** * Sets Adjust Increment Activity Details. * Represents details about an `ADJUST_INCREMENT` [gift card activity type]($m/GiftCardActivityType). * * @maps adjust_increment_activity_details */ public function setAdjustIncrementActivityDetails(?GiftCardActivityAdjustIncrement $adjustIncrementActivityDetails) : void { $this->adjustIncrementActivityDetails = $adjustIncrementActivityDetails; } /** * Returns Adjust Decrement Activity Details. * Represents details about an `ADJUST_DECREMENT` [gift card activity type]($m/GiftCardActivityType). */ public function getAdjustDecrementActivityDetails() : ?GiftCardActivityAdjustDecrement { return $this->adjustDecrementActivityDetails; } /** * Sets Adjust Decrement Activity Details. * Represents details about an `ADJUST_DECREMENT` [gift card activity type]($m/GiftCardActivityType). * * @maps adjust_decrement_activity_details */ public function setAdjustDecrementActivityDetails(?GiftCardActivityAdjustDecrement $adjustDecrementActivityDetails) : void { $this->adjustDecrementActivityDetails = $adjustDecrementActivityDetails; } /** * Returns Refund Activity Details. * Represents details about a `REFUND` [gift card activity type]($m/GiftCardActivityType). */ public function getRefundActivityDetails() : ?GiftCardActivityRefund { return $this->refundActivityDetails; } /** * Sets Refund Activity Details. * Represents details about a `REFUND` [gift card activity type]($m/GiftCardActivityType). * * @maps refund_activity_details */ public function setRefundActivityDetails(?GiftCardActivityRefund $refundActivityDetails) : void { $this->refundActivityDetails = $refundActivityDetails; } /** * Returns Unlinked Activity Refund Activity Details. * Represents details about an `UNLINKED_ACTIVITY_REFUND` [gift card activity * type]($m/GiftCardActivityType). */ public function getUnlinkedActivityRefundActivityDetails() : ?GiftCardActivityUnlinkedActivityRefund { return $this->unlinkedActivityRefundActivityDetails; } /** * Sets Unlinked Activity Refund Activity Details. * Represents details about an `UNLINKED_ACTIVITY_REFUND` [gift card activity * type]($m/GiftCardActivityType). * * @maps unlinked_activity_refund_activity_details */ public function setUnlinkedActivityRefundActivityDetails(?GiftCardActivityUnlinkedActivityRefund $unlinkedActivityRefundActivityDetails) : void { $this->unlinkedActivityRefundActivityDetails = $unlinkedActivityRefundActivityDetails; } /** * Returns Import Activity Details. * Represents details about an `IMPORT` [gift card activity type]($m/GiftCardActivityType). * This activity type is used when Square imports a third-party gift card, in which case the * `gan_source` of the gift card is set to `OTHER`. */ public function getImportActivityDetails() : ?GiftCardActivityImport { return $this->importActivityDetails; } /** * Sets Import Activity Details. * Represents details about an `IMPORT` [gift card activity type]($m/GiftCardActivityType). * This activity type is used when Square imports a third-party gift card, in which case the * `gan_source` of the gift card is set to `OTHER`. * * @maps import_activity_details */ public function setImportActivityDetails(?GiftCardActivityImport $importActivityDetails) : void { $this->importActivityDetails = $importActivityDetails; } /** * Returns Block Activity Details. * Represents details about a `BLOCK` [gift card activity type]($m/GiftCardActivityType). */ public function getBlockActivityDetails() : ?GiftCardActivityBlock { return $this->blockActivityDetails; } /** * Sets Block Activity Details. * Represents details about a `BLOCK` [gift card activity type]($m/GiftCardActivityType). * * @maps block_activity_details */ public function setBlockActivityDetails(?GiftCardActivityBlock $blockActivityDetails) : void { $this->blockActivityDetails = $blockActivityDetails; } /** * Returns Unblock Activity Details. * Represents details about an `UNBLOCK` [gift card activity type]($m/GiftCardActivityType). */ public function getUnblockActivityDetails() : ?GiftCardActivityUnblock { return $this->unblockActivityDetails; } /** * Sets Unblock Activity Details. * Represents details about an `UNBLOCK` [gift card activity type]($m/GiftCardActivityType). * * @maps unblock_activity_details */ public function setUnblockActivityDetails(?GiftCardActivityUnblock $unblockActivityDetails) : void { $this->unblockActivityDetails = $unblockActivityDetails; } /** * Returns Import Reversal Activity Details. * Represents details about an `IMPORT_REVERSAL` [gift card activity type]($m/GiftCardActivityType). */ public function getImportReversalActivityDetails() : ?GiftCardActivityImportReversal { return $this->importReversalActivityDetails; } /** * Sets Import Reversal Activity Details. * Represents details about an `IMPORT_REVERSAL` [gift card activity type]($m/GiftCardActivityType). * * @maps import_reversal_activity_details */ public function setImportReversalActivityDetails(?GiftCardActivityImportReversal $importReversalActivityDetails) : void { $this->importReversalActivityDetails = $importReversalActivityDetails; } /** * Returns Transfer Balance to Activity Details. * Represents details about a `TRANSFER_BALANCE_TO` [gift card activity type]($m/GiftCardActivityType). */ public function getTransferBalanceToActivityDetails() : ?GiftCardActivityTransferBalanceTo { return $this->transferBalanceToActivityDetails; } /** * Sets Transfer Balance to Activity Details. * Represents details about a `TRANSFER_BALANCE_TO` [gift card activity type]($m/GiftCardActivityType). * * @maps transfer_balance_to_activity_details */ public function setTransferBalanceToActivityDetails(?GiftCardActivityTransferBalanceTo $transferBalanceToActivityDetails) : void { $this->transferBalanceToActivityDetails = $transferBalanceToActivityDetails; } /** * Returns Transfer Balance From Activity Details. * Represents details about a `TRANSFER_BALANCE_FROM` [gift card activity * type]($m/GiftCardActivityType). */ public function getTransferBalanceFromActivityDetails() : ?GiftCardActivityTransferBalanceFrom { return $this->transferBalanceFromActivityDetails; } /** * Sets Transfer Balance From Activity Details. * Represents details about a `TRANSFER_BALANCE_FROM` [gift card activity * type]($m/GiftCardActivityType). * * @maps transfer_balance_from_activity_details */ public function setTransferBalanceFromActivityDetails(?GiftCardActivityTransferBalanceFrom $transferBalanceFromActivityDetails) : void { $this->transferBalanceFromActivityDetails = $transferBalanceFromActivityDetails; } /** * 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] public function jsonSerialize(bool $asArrayWhenEmpty = \false) { $json = []; if (isset($this->id)) { $json['id'] = $this->id; } $json['type'] = $this->type; $json['location_id'] = $this->locationId; if (isset($this->createdAt)) { $json['created_at'] = $this->createdAt; } if (!empty($this->giftCardId)) { $json['gift_card_id'] = $this->giftCardId['value']; } if (!empty($this->giftCardGan)) { $json['gift_card_gan'] = $this->giftCardGan['value']; } if (isset($this->giftCardBalanceMoney)) { $json['gift_card_balance_money'] = $this->giftCardBalanceMoney; } if (isset($this->loadActivityDetails)) { $json['load_activity_details'] = $this->loadActivityDetails; } if (isset($this->activateActivityDetails)) { $json['activate_activity_details'] = $this->activateActivityDetails; } if (isset($this->redeemActivityDetails)) { $json['redeem_activity_details'] = $this->redeemActivityDetails; } if (isset($this->clearBalanceActivityDetails)) { $json['clear_balance_activity_details'] = $this->clearBalanceActivityDetails; } if (isset($this->deactivateActivityDetails)) { $json['deactivate_activity_details'] = $this->deactivateActivityDetails; } if (isset($this->adjustIncrementActivityDetails)) { $json['adjust_increment_activity_details'] = $this->adjustIncrementActivityDetails; } if (isset($this->adjustDecrementActivityDetails)) { $json['adjust_decrement_activity_details'] = $this->adjustDecrementActivityDetails; } if (isset($this->refundActivityDetails)) { $json['refund_activity_details'] = $this->refundActivityDetails; } if (isset($this->unlinkedActivityRefundActivityDetails)) { $json['unlinked_activity_refund_activity_details'] = $this->unlinkedActivityRefundActivityDetails; } if (isset($this->importActivityDetails)) { $json['import_activity_details'] = $this->importActivityDetails; } if (isset($this->blockActivityDetails)) { $json['block_activity_details'] = $this->blockActivityDetails; } if (isset($this->unblockActivityDetails)) { $json['unblock_activity_details'] = $this->unblockActivityDetails; } if (isset($this->importReversalActivityDetails)) { $json['import_reversal_activity_details'] = $this->importReversalActivityDetails; } if (isset($this->transferBalanceToActivityDetails)) { $json['transfer_balance_to_activity_details'] = $this->transferBalanceToActivityDetails; } if (isset($this->transferBalanceFromActivityDetails)) { $json['transfer_balance_from_activity_details'] = $this->transferBalanceFromActivityDetails; } $json = \array_filter($json, function ($val) { return $val !== null; }); return !$asArrayWhenEmpty && empty($json) ? new stdClass() : $json; } }