编辑 Gift_Card.php - 文件管理器

✏️ 编辑：Gift_Card.php

路径：/home/forge/woocommerce-square/includes/Gateway/API/Requests/Gift_Card.php

大小：2.69 KB · 修改：2025-12-23 20:26:26 · 权限：0644 · 可写

<?php
/**
 * WooCommerce Square
 *
 * This source file is subject to the GNU General Public License v3.0
 * that is bundled with this package in the file license.txt.
 * It is also available through the world-wide-web at this URL:
 * http://www.gnu.org/licenses/gpl-3.0.html
 * If you did not receive a copy of the license and are unable to
 * obtain it through the world-wide-web, please send an email
 * to license@woocommerce.com so we can send you a copy immediately.
 *
 * DISCLAIMER
 *
 * Do not edit or add to this file if you wish to upgrade WooCommerce Square to newer
 * versions in the future. If you wish to customize WooCommerce Square for your
 * needs please refer to https://docs.woocommerce.com/document/woocommerce-square/
 */

namespace WooCommerce\Square\Gateway\API\Requests;

defined( 'ABSPATH' ) || exit;

use WooCommerce\Square\API;

/**
 * The Gift Card request class.
 *
 * @since 3.7.0
 */
class Gift_Card extends API\Request {
	/**
	 * Location ID.
	 *
	 * @since 4.2.0
	 * @var string
	 */
	public $location_id;

/**
	 * Initializes a new Catalog request.
	 *
	 * @since 3.7.0
	 *
	 * @param string               $location_id Location ID.
	 * @param \Square\SquareClient $api_client  The API client
	 */
	public function __construct( $location_id, $api_client ) {
		$this->square_api  = $api_client->getGiftCardsApi();
		$this->location_id = $location_id;
	}

/**
	 * Sets data for the `retrieveGiftCardFromNonce` API method.
	 *
	 * @param string $nonce Gift Card payment nonce.
	 */
	public function set_retrieve_gift_card_data( $nonce = '' ) {
		$this->square_request    = new \Square\Models\RetrieveGiftCardFromNonceRequest( $nonce );
		$this->square_api_method = 'retrieveGiftCardFromNonce';
		$this->square_api_args   = array( $this->square_request );
	}

/**
	 * Sets data for the `retrieveGiftCardFromGAN` API method.
	 *
	 * @since 4.2.0
	 *
	 * @param string $gan Gift card number.
	 */
	public function set_retrieve_gift_card_from_gan_data( $gan = '' ) {
		$this->square_request    = new \Square\Models\RetrieveGiftCardFromGANRequest( $gan );
		$this->square_api_method = 'retrieveGiftCardFromGAN';
		$this->square_api_args   = array( $this->square_request );
	}

/**
	 * Sets data to create a Gift card.
	 *
	 * @since 4.2.0
	 *
	 * @param $order_id Line item order ID.
	 */
	public function set_create_gift_card_data( $order_id ) {
		$this->square_api_method = 'createGiftCard';
		$gift_card               = new \Square\Models\GiftCard( \Square\Models\GiftCardType::DIGITAL );
		$this->square_request    = new \Square\Models\CreateGiftCardRequest(
			wc_square()->get_idempotency_key( $order_id, false ),
			$this->location_id,
			$gift_card
		);

$this->square_api_args = array( $this->square_request );
	}
}