whoami7 - Manager
:
/
home
/
qbizpnmr
/
arif.umairtax.com
/
vendor
/
square
/
square
/
src
/
Apis
/
Upload File:
files >> /home/qbizpnmr/arif.umairtax.com/vendor/square/square/src/Apis/GiftCardsApi.php
<?php declare(strict_types=1); namespace Square\Apis; use Core\Request\Parameters\BodyParam; use Core\Request\Parameters\HeaderParam; use Core\Request\Parameters\QueryParam; use Core\Request\Parameters\TemplateParam; use CoreInterfaces\Core\Request\RequestMethod; use Square\Http\ApiResponse; use Square\Models\CreateGiftCardRequest; use Square\Models\CreateGiftCardResponse; use Square\Models\LinkCustomerToGiftCardRequest; use Square\Models\LinkCustomerToGiftCardResponse; use Square\Models\ListGiftCardsResponse; use Square\Models\RetrieveGiftCardFromGANRequest; use Square\Models\RetrieveGiftCardFromGANResponse; use Square\Models\RetrieveGiftCardFromNonceRequest; use Square\Models\RetrieveGiftCardFromNonceResponse; use Square\Models\RetrieveGiftCardResponse; use Square\Models\UnlinkCustomerFromGiftCardRequest; use Square\Models\UnlinkCustomerFromGiftCardResponse; class GiftCardsApi extends BaseApi { /** * Lists all gift cards. You can specify optional filters to retrieve * a subset of the gift cards. Results are sorted by `created_at` in ascending order. * * @param string|null $type If a [type](entity:GiftCardType) is provided, the endpoint returns * gift cards of the specified type. * Otherwise, the endpoint returns gift cards of all types. * @param string|null $state If a [state](entity:GiftCardStatus) is provided, the endpoint * returns the gift cards in the specified state. * Otherwise, the endpoint returns the gift cards of all states. * @param int|null $limit If a limit is provided, the endpoint returns only the specified number * of results per page. * The maximum value is 200. The default value is 30. * For more information, see [Pagination](https://developer.squareup.com/docs/working- * with-apis/pagination). * @param string|null $cursor A pagination cursor returned by a previous call to this endpoint. * Provide this cursor to retrieve the next set of results for the original query. * If a cursor is not provided, the endpoint returns the first page of the results. * For more information, see [Pagination](https://developer.squareup.com/docs/working- * with-apis/pagination). * @param string|null $customerId If a customer ID is provided, the endpoint returns only the * gift cards linked to the specified customer. * * @return ApiResponse Response from the API call */ public function listGiftCards( ?string $type = null, ?string $state = null, ?int $limit = null, ?string $cursor = null, ?string $customerId = null ): ApiResponse { $_reqBuilder = $this->requestBuilder(RequestMethod::GET, '/v2/gift-cards') ->auth('global') ->parameters( QueryParam::init('type', $type), QueryParam::init('state', $state), QueryParam::init('limit', $limit), QueryParam::init('cursor', $cursor), QueryParam::init('customer_id', $customerId) ); $_resHandler = $this->responseHandler()->type(ListGiftCardsResponse::class)->returnApiResponse(); return $this->execute($_reqBuilder, $_resHandler); } /** * Creates a digital gift card or registers a physical (plastic) gift card. After the gift card * is created, you must call [CreateGiftCardActivity]($e/GiftCardActivities/CreateGiftCardActivity) * to activate the card with an initial balance before it can be used for payment. * * @param CreateGiftCardRequest $body An object containing the fields to POST for the request. * See the corresponding object definition for field details. * * @return ApiResponse Response from the API call */ public function createGiftCard(CreateGiftCardRequest $body): ApiResponse { $_reqBuilder = $this->requestBuilder(RequestMethod::POST, '/v2/gift-cards') ->auth('global') ->parameters(HeaderParam::init('Content-Type', 'application/json'), BodyParam::init($body)); $_resHandler = $this->responseHandler()->type(CreateGiftCardResponse::class)->returnApiResponse(); return $this->execute($_reqBuilder, $_resHandler); } /** * Retrieves a gift card using the gift card account number (GAN). * * @param RetrieveGiftCardFromGANRequest $body An object containing the fields to POST for the * request. * * See the corresponding object definition for field details. * * @return ApiResponse Response from the API call */ public function retrieveGiftCardFromGAN(RetrieveGiftCardFromGANRequest $body): ApiResponse { $_reqBuilder = $this->requestBuilder(RequestMethod::POST, '/v2/gift-cards/from-gan') ->auth('global') ->parameters(HeaderParam::init('Content-Type', 'application/json'), BodyParam::init($body)); $_resHandler = $this->responseHandler()->type(RetrieveGiftCardFromGANResponse::class)->returnApiResponse(); return $this->execute($_reqBuilder, $_resHandler); } /** * Retrieves a gift card using a secure payment token that represents the gift card. * * @param RetrieveGiftCardFromNonceRequest $body An object containing the fields to POST for the * request. * * See the corresponding object definition for field details. * * @return ApiResponse Response from the API call */ public function retrieveGiftCardFromNonce(RetrieveGiftCardFromNonceRequest $body): ApiResponse { $_reqBuilder = $this->requestBuilder(RequestMethod::POST, '/v2/gift-cards/from-nonce') ->auth('global') ->parameters(HeaderParam::init('Content-Type', 'application/json'), BodyParam::init($body)); $_resHandler = $this->responseHandler()->type(RetrieveGiftCardFromNonceResponse::class)->returnApiResponse(); return $this->execute($_reqBuilder, $_resHandler); } /** * Links a customer to a gift card, which is also referred to as adding a card on file. * * @param string $giftCardId The ID of the gift card to be linked. * @param LinkCustomerToGiftCardRequest $body An object containing the fields to POST for the * request. * * See the corresponding object definition for field details. * * @return ApiResponse Response from the API call */ public function linkCustomerToGiftCard(string $giftCardId, LinkCustomerToGiftCardRequest $body): ApiResponse { $_reqBuilder = $this->requestBuilder(RequestMethod::POST, '/v2/gift-cards/{gift_card_id}/link-customer') ->auth('global') ->parameters( TemplateParam::init('gift_card_id', $giftCardId), HeaderParam::init('Content-Type', 'application/json'), BodyParam::init($body) ); $_resHandler = $this->responseHandler()->type(LinkCustomerToGiftCardResponse::class)->returnApiResponse(); return $this->execute($_reqBuilder, $_resHandler); } /** * Unlinks a customer from a gift card, which is also referred to as removing a card on file. * * @param string $giftCardId The ID of the gift card to be unlinked. * @param UnlinkCustomerFromGiftCardRequest $body An object containing the fields to POST for * the request. * * See the corresponding object definition for field details. * * @return ApiResponse Response from the API call */ public function unlinkCustomerFromGiftCard( string $giftCardId, UnlinkCustomerFromGiftCardRequest $body ): ApiResponse { $_reqBuilder = $this->requestBuilder(RequestMethod::POST, '/v2/gift-cards/{gift_card_id}/unlink-customer') ->auth('global') ->parameters( TemplateParam::init('gift_card_id', $giftCardId), HeaderParam::init('Content-Type', 'application/json'), BodyParam::init($body) ); $_resHandler = $this->responseHandler()->type(UnlinkCustomerFromGiftCardResponse::class)->returnApiResponse(); return $this->execute($_reqBuilder, $_resHandler); } /** * Retrieves a gift card using the gift card ID. * * @param string $id The ID of the gift card to retrieve. * * @return ApiResponse Response from the API call */ public function retrieveGiftCard(string $id): ApiResponse { $_reqBuilder = $this->requestBuilder(RequestMethod::GET, '/v2/gift-cards/{id}') ->auth('global') ->parameters(TemplateParam::init('id', $id)); $_resHandler = $this->responseHandler()->type(RetrieveGiftCardResponse::class)->returnApiResponse(); return $this->execute($_reqBuilder, $_resHandler); } }
Copyright ©2021 || Defacer Indonesia