8889841cPK     —[¬â„…   …     Commands/PaymentComplete.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Commands;

/***
 * @since 2.18.0
 */
class PaymentComplete extends PaymentCommand {}
PK     —[RDDwr   r     Commands/GatewayCommand.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Commands;

/***
 * @since 2.18.0
 */
interface GatewayCommand {
}
PK     —[k'¨Ž  Ž  !  Commands/SubscriptionComplete.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Commands;

/***
 * @since 2.18.0
 */
class SubscriptionComplete implements GatewayCommand
{
    /**
     * The Gateway Transaction / Charge Record ID
     *
     * @var string
     */
    public $gatewayTransactionId;
    /**
     * The Gateway Subscription Record ID
     *
     * @var string
     */
    public $gatewaySubscriptionId;

    /**
     * @since 2.18.0
     */
    public function __construct(string $gatewayTransactionId, string $gatewaySubscriptionId)
    {
        $this->gatewayTransactionId = $gatewayTransactionId;
        $this->gatewaySubscriptionId = $gatewaySubscriptionId;
    }
}
PK     —[Ö² ½‡   ‡     Commands/PaymentProcessing.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Commands;

/***
 * @since 2.18.0
 */
class PaymentProcessing extends PaymentCommand {}
PK     —[ÜsÙPA  A    Commands/RespondToBrowser.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Commands;

/***
 * @since 2.18.0
 */
class RespondToBrowser implements GatewayCommand {
    /**
     *
     * @var array
     */
    public $data;

    /**
     * @since 2.18.0
     */
    public function __construct(array $data)
    {
        $this->data = $data;
    }
}
PK     —[h(ðV…   …     Commands/PaymentRefunded.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Commands;

/***
 * @since 2.18.0
 */
class PaymentRefunded extends PaymentCommand {}
PK     —[Ý+f­  ­  #  Commands/SubscriptionProcessing.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Commands;

/**
 * @since 2.23.2
 */
class SubscriptionProcessing implements GatewayCommand
{
    /**
     * The Gateway Transaction / Charge Record ID
     *
     * @var string|null
     */
    public $gatewayTransactionId;
    /**
     * The Gateway Subscription Record ID
     *
     * @var string
     */
    public $gatewaySubscriptionId;

    /**
     * @since 2.23.2
     */
    public function __construct(
        string $gatewaySubscriptionId,
        string $gatewayTransactionId = null
    ) {
        $this->gatewayTransactionId = $gatewayTransactionId;
        $this->gatewaySubscriptionId = $gatewaySubscriptionId;
    }
}
PK     —[F¡z—W  W    Commands/RedirectOffsite.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Commands;

/***
 * @since 2.18.0
 */
class RedirectOffsite implements GatewayCommand {
    /**
     * @var string
     */
    public $redirectUrl;

    /**
     * @since 2.18.0
     */
    public function __construct(string $redirectUrl)
    {
        $this->redirectUrl = $redirectUrl;
    }
}
PK     —[øi¢      Commands/PaymentCommand.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Commands;

/***
 * @since 2.18.0
 */
abstract class PaymentCommand implements GatewayCommand
{
    /**
     * The Gateway Transaction / Charge Record ID
     *
     * @var string|null
     */
    public $gatewayTransactionId;

    /**
     * Notes to be added to the payment.
     *
     * @var array|string[]
     */
    public $paymentNotes = [];

    /**
     * @param string|null $gatewayTransactionId
     *
     * @return static
     */
    public static function make(string $gatewayTransactionId = null): PaymentCommand
    {
        return new static($gatewayTransactionId);
    }

    /**
     * @since      2.18.0
     * @since 2.23.1 Make constructor final to avoid unsafe usage of `new static()`.
     *
     * @param string|null $gatewayTransactionId
     */
    final public function __construct(string $gatewayTransactionId = null)
    {
        $this->gatewayTransactionId = $gatewayTransactionId;
    }

    /**
     * @since 2.22.0 add type, so it is typesafe
     *
     * @param string|string[] ...$paymentNotes
     *
     * @return $this
     */
    public function setPaymentNotes(string ...$paymentNotes): PaymentCommand
    {
        $this->paymentNotes = $paymentNotes;

        return $this;
    }

    /**
     * @param string $gatewayTransactionId
     *
     * @return $this
     */
    public function setTransactionId(string $gatewayTransactionId): PaymentCommand
    {
        $this->gatewayTransactionId = $gatewayTransactionId;

        return $this;
    }
}
PK     —[Ç0B6†   †     Commands/PaymentAbandoned.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Commands;

/***
 * @since 2.18.0
 */
class PaymentAbandoned extends PaymentCommand {}
PK     —[0
ßß  ß  <  Contracts/Subscription/SubscriptionPaymentMethodEditable.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Contracts\Subscription;

use Give\Subscriptions\Models\Subscription;

/**
 * @since 2.20.0
 */
interface SubscriptionPaymentMethodEditable
{
    /**
     * Update subscription payment method.
     *
     *
     * @since 2.21.2 Second parameter has been made required.
     *             For example a developer can use "givewp_donor_dashboard_edit_subscription_payment_method_gateway_data_{$gateway->getId()}" filter
     *             To provide payment method request data to gateway before updating payment method (filter is in recurring donations  add-on).
     * @since 2.20.0
     */
    public function updateSubscriptionPaymentMethod(Subscription $subscription, $gatewayData);
}
PK     —[v}Ä6Ý  Ý  5  Contracts/Subscription/SubscriptionAmountEditable.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Contracts\Subscription;

use Give\Framework\Support\ValueObjects\Money;
use Give\Subscriptions\Models\Subscription;

/**
 * @since 2.20.0
 */
interface SubscriptionAmountEditable
{
    /**
     * Update subscription amount.
     *
     * @since 2.21.2 Add second argument to specify the new amount.
     * @since 2.20.0
     */
    public function updateSubscriptionAmount(Subscription $subscription, Money $newRenewalAmount);
}
PK     —[³î)Lƒ  ƒ  A  Contracts/Subscription/SubscriptionTransactionsSynchronizable.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Contracts\Subscription;

use Give\Subscriptions\Models\Subscription;

/**
 * @since 2.20.0
 */
interface SubscriptionTransactionsSynchronizable
{
    /**
     * Synchronizes a subscription and its transactions with the gateway.
     *
     * @since 2.20.0
     */
    public function synchronizeSubscription(Subscription $subscription);
}
PK     —[¾-Ë	9  9  8  Contracts/Subscription/SubscriptionDashboardLinkable.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Contracts\Subscription;

use Give\Subscriptions\Models\Subscription;

/**
 * @since 2.21.2
 */
interface SubscriptionDashboardLinkable
{
    /**
     * @since 2.21.2
     */
    public function gatewayDashboardSubscriptionUrl(Subscription $subscription): string;
}
PK     —[ôB)¿  ¿  %  Contracts/PaymentGatewaysIterator.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Contracts;

/**
 * @since 2.18.0
 * @property-read array $gateways
 */
class PaymentGatewaysIterator implements \Iterator
{
    /**
     * @since 2.18.0
     * @return string
     */
    #[\ReturnTypeWillChange]
    public function current()
    {
        return current($this->gateways);
    }

    /**
     * @since 2.18.0
     */
    #[\ReturnTypeWillChange]
    public function next()
    {
        next($this->gateways);
    }

    /**
     * @since 2.18.0
     * @return string
     */
    #[\ReturnTypeWillChange]
    public function key()
    {
        return key($this->gateways);
    }

    /**
     * @since 2.18.0
     * @return bool
     */
    #[\ReturnTypeWillChange]
    public function valid()
    {
        return key($this->gateways) !== null;
    }

    /**
     * @since 2.18.0
     */
    #[\ReturnTypeWillChange]
    public function rewind()
    {
        reset($this->gateways);
    }
}
PK     —[£ö°  °  %  Contracts/PaymentGatewayInterface.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Contracts;

use Give\Donations\Models\Donation;
use Give\Framework\Exceptions\Primitives\Exception;
use Give\Framework\PaymentGateways\Commands\GatewayCommand;
use Give\Framework\PaymentGateways\Commands\RedirectOffsite;
use Give\Framework\PaymentGateways\Exceptions\PaymentGatewayException;

/**
 * @since 2.18.0
 */
interface PaymentGatewayInterface extends SubscriptionModuleInterface
{

    /**
     * Specify which form versions the gateway supports
     *
     * Currently, this corresponds to the major GiveWP versions (2, 3, etc)
     *
     * This will likely be removed in the future when GiveWP 2.x is no longer supported
     *
     * @since 2.30.0
     */
    public function supportsFormVersions(): array;

    /**
     * Enqueue script for the gateway to display fields and interact with the form
     *
     * @since 2.30.0
     */
    public function enqueueScript(int $formId);

    /**
     * Return a unique identifier for the gateway
     *
     * @since 2.18.0
     */
    public static function id(): string;

    /**
     * Return a unique identifier for the gateway
     *
     * @since 2.18.0
     *
     * @deprecated 2.22.2 use static id() method instead, can use on an instance: $this::id() or $gateway::id() â€” even in strings
     */
    public function getId(): string;

    /**
     * Returns a human-readable name for the gateway
     *
     * @since 2.18.0
     *
     * @return string - Translated text
     */
    public function getName(): string;

    /**
     * Returns a human-readable label for use when a donor selects a payment method to use
     *
     * @since 2.18.0
     *
     * @return string - Translated text
     */
    public function getPaymentMethodLabel(): string;

    /**
     * Determines if refunds are supported
     *
     * @since 2.29.0
     *
     * @return bool
     */
    public function supportsRefund(): bool;

    /**
     * Determines if subscriptions are supported
     *
     * @since 2.18.0
     *
     * @return bool
     */
    public function supportsSubscriptions(): bool;

    /**
     * Create a payment with gateway
     * Note: You can use "givewp_create_payment_gateway_data_{$gatewayId}" filter hook to pass additional data for gateway which helps/require to process transaction.
     *       This filter will help to add additional arguments to this function which should be optional otherwise you will get PHP fatal error.
     *
     * @since 2.21.2 Add second param to function to pass gateway data to process transaction
     * @since 2.18.0
     *
     * @param array $gatewayData
     *
     * @return GatewayCommand|RedirectOffsite|void
     *
     * @throws PaymentGatewayException
     * @throws Exception
     */
    public function createPayment(Donation $donation, $gatewayData);

    /**
     * @since 2.20.0
     *
     * @param Donation $donation
     *
     * @return mixed
     */
    public function refundDonation(Donation $donation);
}
PK     —[ž>    )  Contracts/SubscriptionModuleInterface.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Contracts;

use Give\Donations\Models\Donation;
use Give\Framework\PaymentGateways\Commands\GatewayCommand;
use Give\Framework\PaymentGateways\Commands\RedirectOffsite;
use Give\Subscriptions\Models\Subscription;

interface SubscriptionModuleInterface
{
    /**
     * Create a subscription with gateway
     * Note: You can use "givewp_create_subscription_gateway_data_{$gatewayId}" filter hook to pass additional data for gateway which helps/require to process initial subscription transaction.
     *       This filter will help to add additional arguments to this function which should be optional otherwise you will get PHP fatal error.
     *
     * @since 2.21.2 Add third param to function to pass gateway data to process transaction
     * @since 2.18.0
     *
     * @param array $gatewayData
     *
     * @return GatewayCommand|RedirectOffsite
     */
    public function createSubscription(Donation $donation, Subscription $subscription, $gatewayData);

    /**
     * Cancel subscription.
     *
     * @since 2.20.0
     */
    public function cancelSubscription(Subscription $subscription);

    /**
     * Returns whether the gateway supports syncing subscriptions.
     *
     * @since 2.20.0
     */
    public function canSyncSubscriptionWithPaymentGateway(): bool;

    /**
     * Whether the gateway supports updating subscription amount.
     *
     * @since 2.20.0
     */
    public function canUpdateSubscriptionAmount(): bool;

    /**
     * Whether the gateway supports updating subscription method.
     *
     * @since 2.20.0
     */
    public function canUpdateSubscriptionPaymentMethod(): bool;
}
PK     —["M	  M	  ,  Actions/HandleGatewaySubscriptionCommand.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Actions;

use Exception;
use Give\Donations\Models\Donation;
use Give\Framework\FieldsAPI\Exceptions\TypeNotSupported;
use Give\Framework\Http\Response\Types\JsonResponse;
use Give\Framework\Http\Response\Types\RedirectResponse;
use Give\Framework\PaymentGateways\CommandHandlers\RedirectOffsiteHandler;
use Give\Framework\PaymentGateways\CommandHandlers\RespondToBrowserHandler;
use Give\Framework\PaymentGateways\CommandHandlers\SubscriptionCompleteHandler;
use Give\Framework\PaymentGateways\CommandHandlers\SubscriptionProcessingHandler;
use Give\Framework\PaymentGateways\Commands\GatewayCommand;
use Give\Framework\PaymentGateways\Commands\RedirectOffsite;
use Give\Framework\PaymentGateways\Commands\RespondToBrowser;
use Give\Framework\PaymentGateways\Commands\SubscriptionComplete;
use Give\Framework\PaymentGateways\Commands\SubscriptionProcessing;
use Give\Subscriptions\Models\Subscription;


/**
 * @since 2.27.0
 */
class HandleGatewaySubscriptionCommand
{
    /**
     *
     * Handle gateway subscription command
     *
     * @since 2.27.0 return responses
     * @since 2.26.0 add RespondToBrowser command
     * @since 2.21.0 Handle RedirectOffsite response.
     * @since 2.18.0
     *
     * @return JsonResponse|RedirectResponse
     * @throws TypeNotSupported
     * @throws Exception
     */
    public function __invoke(
        GatewayCommand $command,
        Donation $donation,
        Subscription $subscription
    ) {
        if ($command instanceof SubscriptionComplete) {
            (new SubscriptionCompleteHandler())($command, $subscription, $donation);

            return new RedirectResponse(give_get_success_page_uri());
        }

        if ($command instanceof SubscriptionProcessing) {
            (new SubscriptionProcessingHandler($command, $subscription, $donation))();

            return new RedirectResponse(give_get_success_page_uri());
        }

        if ($command instanceof RedirectOffsite) {
            return (new RedirectOffsiteHandler())($command);
        }

        if ($command instanceof RespondToBrowser) {
            return (new RespondToBrowserHandler())($command);
        }

        throw new TypeNotSupported(
            sprintf(
                "Return type must be an instance of %s",
                GatewayCommand::class
            )
        );
    }
}
PK     —[y`Ÿ†,  ,  #  Actions/GenerateGatewayRouteUrl.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Actions;

class GenerateGatewayRouteUrl
{
    /**
     * @param  string  $gatewayId
     * @param  string  $gatewayMethod
     * @param  array|null  $args
     * @return string
     * @since 2.18.0
     *
     * @since 2.19.0 remove $donationId param in favor of args
     *
     */
    public function __invoke(string $gatewayId, string $gatewayMethod, array $args = []): string
    {
        $queryArgs = [
            'give-listener' => 'give-gateway',
            'give-gateway-id' => $gatewayId,
            'give-gateway-method' => $gatewayMethod,
        ];

        if ($args) {
            $queryArgs = array_merge($queryArgs, $args);
        }

        return esc_url_raw(add_query_arg(
            $queryArgs,
            home_url()
        ));
    }
}
PK     —[ çÊn
  n
  '  Actions/HandleGatewayPaymentCommand.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Actions;

use Exception;
use Give\Donations\Models\Donation;
use Give\Framework\FieldsAPI\Exceptions\TypeNotSupported;
use Give\Framework\Http\Response\Types\JsonResponse;
use Give\Framework\Http\Response\Types\RedirectResponse;
use Give\Framework\PaymentGateways\CommandHandlers\PaymentCompleteHandler;
use Give\Framework\PaymentGateways\CommandHandlers\PaymentProcessingHandler;
use Give\Framework\PaymentGateways\CommandHandlers\PaymentRefundedHandler;
use Give\Framework\PaymentGateways\CommandHandlers\RedirectOffsiteHandler;
use Give\Framework\PaymentGateways\CommandHandlers\RespondToBrowserHandler;
use Give\Framework\PaymentGateways\Commands\GatewayCommand;
use Give\Framework\PaymentGateways\Commands\PaymentComplete;
use Give\Framework\PaymentGateways\Commands\PaymentProcessing;
use Give\Framework\PaymentGateways\Commands\PaymentRefunded;
use Give\Framework\PaymentGateways\Commands\RedirectOffsite;
use Give\Framework\PaymentGateways\Commands\RespondToBrowser;


/**
 * @since 2.27.0
 */
class HandleGatewayPaymentCommand
{
    /**
     * Handle gateway command
     *
     * @since 2.29.0 Handle PaymentRefunded command
     * @since      2.27.0 return responses
     * @since      2.18.0
     *
     * @return JsonResponse|RedirectResponse
     * @throws TypeNotSupported|Exception
     */
    public function __invoke(GatewayCommand $command, Donation $donation)
    {
        if ($command instanceof PaymentComplete) {
            $handler = new PaymentCompleteHandler($command);

            $handler->handle($donation);

            return new RedirectResponse(give_get_success_page_uri());
        }

        if ($command instanceof PaymentProcessing) {
            $handler = new PaymentProcessingHandler($command);

            $handler->handle($donation);

            return new RedirectResponse(give_get_success_page_uri());
        }

        if ($command instanceof PaymentRefunded) {
            $handler = new PaymentRefundedHandler($command);
            $handler->handle($donation);
            $url = isset($_REQUEST['_wp_http_referer']) ? home_url($_REQUEST['_wp_http_referer']) : home_url('/');

            return new RedirectResponse($url);
        }

        if ($command instanceof RedirectOffsite) {
            return (new RedirectOffsiteHandler())($command);
        }

        if ($command instanceof RespondToBrowser) {
            return (new RespondToBrowserHandler())($command);
        }

        throw new TypeNotSupported(
            sprintf(
                "Return type must be an instance of %s",
                GatewayCommand::class
            )
        );
    }
}
PK     —[iÙ1wÁ  Á    Routes/GatewayRoute.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Routes;

use Give\Framework\PaymentGateways\DataTransferObjects\GatewayRouteData;
use Give\Framework\PaymentGateways\Exceptions\PaymentGatewayException;
use Give\Framework\PaymentGateways\Log\PaymentGatewayLog;
use Give\Framework\PaymentGateways\PaymentGateway;
use Give\Framework\PaymentGateways\PaymentGatewayRegister;
use Give\Framework\PaymentGateways\Traits\HandleHttpResponses;

use function Give\Framework\Http\Response\response;

/**
 * @since 2.18.0
 */
class GatewayRoute
{
    use HandleHttpResponses;

    /**
     * This is our entry point into the Gateway Routing system.
     *
     * @since 2.19.0 - validate secureRouteMethods
     * @since 2.18.0
     *
     * @return void
     *
     * @throws PaymentGatewayException
     */
    public function __invoke()
    {
        if ($this->isValidListener()) {
            /** @var PaymentGatewayRegister $paymentGatewaysRegister */
            $paymentGatewaysRegister = give(PaymentGatewayRegister::class);

            // get all registered gateways
            $paymentGateways = $paymentGatewaysRegister->getPaymentGateways();

            // get all registered gateway ids
            $gatewayIds = array_keys($paymentGateways);

            // make sure required params are valid
            if (!$this->isValidRequest($gatewayIds)) {
                throw new PaymentGatewayException('This route is not valid.');
            }

            // create DTO from GET request
            $data = GatewayRouteData::fromRequest(give_clean($_GET));

            /**
             * Get the PaymentGateway instance
             *
             * @var PaymentGateway $gateway
             */
            $gateway = give($paymentGateways[$data->gatewayId]);

            if (!$gateway->supportsMethodRoute($data->gatewayMethod)) {
                throw new PaymentGatewayException('The gateway method does not exist.');
            }

            // If method is in secureRouteMethods then, validate signature
            if (in_array($data->gatewayMethod, $gateway->secureRouteMethods, true)) {
                $this->validateSignature($data->routeSignature, $data);
            }

            // Navigate to our payment gateway api to handle calling the gateway's method
            $this->handleGatewayRouteMethod($gateway, $data->gatewayMethod, $data->queryParams);

            exit;
        }
    }

    /**
     * Check if the request is valid
     *
     * @since 2.19.0 remove required check give-donation-id
     *
     * @since 2.18.0
     *
     * @param array $gatewayIds
     *
     * @return bool
     *
     * @example ?give-listener=give-gateway&give-gateway-id=test-gateway&give-donation-id=1&give-gateway-method=returnFromOffsiteRedirect
     *
     */
    private function isValidRequest($gatewayIds)
    {
        $isset = isset($_GET['give-gateway-id'], $_GET['give-gateway-method']);
        $idValid = in_array($_GET['give-gateway-id'], $gatewayIds, true);

        return $isset && $idValid;
    }

    /**
     * Check if the listener is valid
     *
     * @since 2.18.0
     *
     * @return bool
     */
    private function isValidListener()
    {
        return isset($_GET['give-listener']) && $_GET['give-listener'] === 'give-gateway';
    }

    /**
     * Validate signature using nonces
     *
     * @since 2.19.5 replace nonce with hash
     * @since 2.19.4 replace RouteSignature args with unique donationId
     * @since 2.19.0
     *
     * @param string $routeSignature
     * @param GatewayRouteData $data
     *
     * @return void
     */
    private function validateSignature($routeSignature, GatewayRouteData $data)
    {
        $signature = new RouteSignature(
            $data->gatewayId,
            $data->gatewayMethod,
            $data->routeSignatureId,
            $data->routeSignatureExpiration
        );

        if (!$signature->isValid($routeSignature)) {
            PaymentGatewayLog::error(
                'Invalid Secure Route',
                [
                    'routeSignature' => $routeSignature,
                    'signature' => $signature,
                    'signatureString' => $signature->toString(),
                    'signatureHash' => $signature->toHash(),
                    'signatureExpiration' => $signature->expiration,
                    'data' => $data
                ]
            );

            wp_die('Forbidden', 403);
        }
    }

    /**
     * Handle gateway route method
     *
     * @since 2.18.0
     *
     * @since 2.19.0 - replace $donationId with $queryParams array
     * @since 2.19.0 Record gateway id, callback method name and query params in log.
     *
     * @param PaymentGateway $gateway
     * @param string $method
     * @param array $queryParams
     */
    private function handleGatewayRouteMethod(PaymentGateway $gateway, $method, $queryParams)
    {
        try {
            $this->handleResponse($gateway->callRouteMethod($method, $queryParams));
        } catch (PaymentGatewayException $paymentGatewayException) {
            $this->handleResponse(response()->json($paymentGatewayException->getMessage()));
        } catch (\Exception $exception) {
            PaymentGatewayLog::error(
                $exception->getMessage(),
                [
                    'Payment Gateway' => $gateway::id(),
                    'Payment Gateway Method' => $method,
                    'Query Params' => $queryParams
                ]
            );
            $this->handleResponse(
                response()->json(
                    __(
                        'An unexpected error occurred while processing your donation.  Please try again or contact us to help resolve.',
                        'give'
                    )
                )
            );
        }
    }
}
PK     —[œym®	  	    Routes/RouteSignature.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Routes;

use Give\Framework\Shims\Shim;

/**
 * Route signature for creating secure gateway route methods
 *
 * @since 2.19.0
 */
class RouteSignature
{
    /**
     * @var string
     */
    private $signature;
    /**
     * @var string
     */
    public $expiration;

    /**
     * @since 2.19.5 replace wp_create_nonce with wp_hash and timestamp expiration
     * @since 2.19.4 replace RouteSignature args with unique donationId
     * @since 2.19.0
     *
     * @param  int  $gatewayId
     * @param  string  $gatewayMethod
     * @param  int  $donationId
     * @param  string  $expiration
     */
    public function __construct($gatewayId, $gatewayMethod, $donationId, $expiration = null)
    {
        $this->expiration = $expiration ?: $this->createExpirationTimestamp();
        $this->signature = $this->generateSignatureString($gatewayId, $gatewayMethod, $donationId, $this->expiration);
    }


    /**
     * @since 2.19.5
     *
     * @param  string  $gatewayId
     * @param  string  $gatewayMethod
     * @param  int  $donationId
     * @param  string  $expiration
     * @return string
     */
    private function generateSignatureString($gatewayId, $gatewayMethod, $donationId, $expiration)
    {
        return "$gatewayId@$gatewayMethod:$donationId|$expiration";
    }

    /**
     * @since 2.19.0
     *
     * @return string
     */
    public function toString()
    {
        return $this->signature;
    }

    /**
     * @since 2.19.5
     *
     * @return string
     */
    public function toHash()
    {
        return wp_hash($this->signature);
    }

    /**
     * Create expiration timestamp
     *
     * @since 2.19.5
     *
     * @return string
     */
    public function createExpirationTimestamp()
    {
        return (string)current_datetime()->modify('+1 day')->getTimestamp();
    }


    /**
     * @since 2.19.5
     *
     * @param  string  $suppliedSignature
     * @return bool
     */
    public function isValid($suppliedSignature)
    {
        $isSignatureValid = hash_equals(
            $suppliedSignature,
            $this->toHash()
        );

        $isNotExpired = ((int)$this->expiration) >= current_datetime()->getTimestamp();

        return $isSignatureValid && $isNotExpired;
    }
}
PK     —[^\8  8  *  CommandHandlers/PaymentCompleteHandler.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\CommandHandlers;

use Give\Donations\ValueObjects\DonationStatus;
use Give\Framework\PaymentGateways\Commands\PaymentComplete;

class PaymentCompleteHandler extends PaymentHandler
{
    /**
     * @param PaymentComplete $paymentCommand
     */
    public function __construct(PaymentComplete $paymentCommand)
    {
        parent::__construct($paymentCommand);
    }

    /**
     * @since 2.21.0
     */
    protected function getPaymentStatus(): DonationStatus
    {
        return DonationStatus::COMPLETE();
    }
}
PK     —[2ffq;  ;  +  CommandHandlers/PaymentAbandonedHandler.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\CommandHandlers;

use Give\Donations\ValueObjects\DonationStatus;
use Give\Framework\PaymentGateways\Commands\PaymentAbandoned;

class PaymentAbandonedHandler extends PaymentHandler
{
    /**
     * @param PaymentAbandoned $paymentCommand
     */
    public function __construct(PaymentAbandoned $paymentCommand)
    {
        parent::__construct($paymentCommand);
    }

    /**
     * @inheritDoc
     */
    protected function getPaymentStatus(): DonationStatus
    {
        return DonationStatus::ABANDONED();
    }
}
PK     —[½;ê<K  K  ,  CommandHandlers/PaymentProcessingHandler.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\CommandHandlers;

use Give\Donations\ValueObjects\DonationStatus;
use Give\Framework\PaymentGateways\Commands\PaymentProcessing;

class PaymentProcessingHandler extends PaymentHandler
{
    /**
     * @param PaymentProcessing $paymentCommand
     */
    public function __construct(PaymentProcessing $paymentCommand)
    {
        parent::__construct($paymentCommand);
    }

    /**
     * @return DonationStatus
     */
    protected function getPaymentStatus(): DonationStatus
    {
        return DonationStatus::PROCESSING();
    }
}
PK     —[š÷q<$  $  /  CommandHandlers/SubscriptionCompleteHandler.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\CommandHandlers;

use Exception;
use Give\Donations\Models\Donation;
use Give\Donations\ValueObjects\DonationStatus;
use Give\Framework\PaymentGateways\Commands\SubscriptionComplete;
use Give\Subscriptions\Models\Subscription;
use Give\Subscriptions\ValueObjects\SubscriptionStatus;

class SubscriptionCompleteHandler
{
    /**
     * @since 2.21.0 replace logic with models
     * @since 2.18.0
     *
     * @throws Exception
     */
    public function __invoke(SubscriptionComplete $subscriptionComplete, Subscription $subscription, Donation $donation)
    {
        $donation->status = DonationStatus::COMPLETE();
        $donation->gatewayTransactionId = $subscriptionComplete->gatewayTransactionId;
        $donation->save();

        $subscription->status = SubscriptionStatus::ACTIVE();
        $subscription->gatewaySubscriptionId = $subscriptionComplete->gatewaySubscriptionId;
        $subscription->transactionId = $subscriptionComplete->gatewayTransactionId;
        $subscription->save();
    }
}
PK     —[Î¡®6  6  *  CommandHandlers/PaymentRefundedHandler.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\CommandHandlers;

use Give\Donations\ValueObjects\DonationStatus;
use Give\Framework\PaymentGateways\Commands\PaymentRefunded;

class PaymentRefundedHandler extends PaymentHandler
{
    /**
     * @param PaymentRefunded $paymentCommand
     */
    public function __construct(PaymentRefunded $paymentCommand)
    {
        parent::__construct($paymentCommand);
    }

    /**
     * @inheritdoc
     */
    protected function getPaymentStatus(): DonationStatus
    {
        return DonationStatus::REFUNDED();
    }
}
PK     —[àßÛ¶  ¶  +  CommandHandlers/RespondToBrowserHandler.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\CommandHandlers;

use Give\Framework\Http\Response\Types\JsonResponse;
use Give\Framework\PaymentGateways\Commands\RespondToBrowser;

use function Give\Framework\Http\Response\response;

class RespondToBrowserHandler  {
    /**
     * @since 2.18.0
     */
    public function __invoke(RespondToBrowser $command): JsonResponse
    {
        return response()->json($command->data);
    }
}
PK     —[5AÞõ  õ  "  CommandHandlers/PaymentHandler.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\CommandHandlers;

use Give\Donations\Models\Donation;
use Give\Donations\Models\DonationNote;
use Give\Donations\ValueObjects\DonationStatus;
use Give\Framework\Exceptions\Primitives\Exception;
use Give\Framework\PaymentGateways\Commands\PaymentCommand;

abstract class PaymentHandler
{
    /**
     * @var PaymentCommand
     */
    protected $paymentCommand;

    /**
     * @since 2.21.0 change return type to DonationStatus
     *
     * @since 2.18.0
     */
    abstract protected function getPaymentStatus(): DonationStatus;

    /**
     * @param PaymentCommand $paymentCommand
     */
    public function __construct(PaymentCommand $paymentCommand)
    {
        $this->paymentCommand = $paymentCommand;
    }

    /**
     * @since 2.18.0
     */
    public static function make(PaymentCommand $paymentCommand): PaymentHandler
    {
        return new static($paymentCommand);
    }

    /**
     * @since 2.21.0 replace $donationId with Donation model
     * @since 2.18.0
     *
     * @throws Exception
     */
    public function handle(Donation $donation)
    {
        $donation->status = $this->getPaymentStatus();
        $donation->gatewayTransactionId = $this->paymentCommand->gatewayTransactionId;
        $donation->save();

        foreach ($this->paymentCommand->paymentNotes as $paymentNote) {
            DonationNote::create([
                'donationId' => $donation->id,
                'content' => $paymentNote
            ]);
        }
    }
}
PK     —[Ö²Äþ  þ  1  CommandHandlers/SubscriptionProcessingHandler.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\CommandHandlers;

use Exception;
use Give\Donations\Models\Donation;
use Give\Donations\ValueObjects\DonationStatus;
use Give\Framework\PaymentGateways\Commands\SubscriptionProcessing;
use Give\Subscriptions\Models\Subscription;
use Give\Subscriptions\ValueObjects\SubscriptionStatus;

/**
 * @since 2.23.2
 */
class SubscriptionProcessingHandler
{
    /**
     * @since 2.23.2
     * @var SubscriptionProcessing
     */
    private $subscriptionComplete;
    /**
     * @since 2.23.2
     * @var Subscription
     */
    private $subscription;
    /**
     * @since 2.23.2
     * @var Donation
     */
    private $donation;

    /**
     * @since 2.23.2
     */
    public function __construct(
        SubscriptionProcessing $subscriptionComplete,
        Subscription $subscription,
        Donation $donation
    ) {
        $this->subscriptionComplete = $subscriptionComplete;
        $this->subscription = $subscription;
        $this->donation = $donation;
    }

    /**
     * @since 2.23.2
     * @return void
     * @throws Exception
     */
    public function __invoke()
    {
        $this->donation->status = DonationStatus::PROCESSING();
        $this->subscription->status = SubscriptionStatus::PENDING();
        $this->subscription->gatewaySubscriptionId = $this->subscriptionComplete->gatewaySubscriptionId;

        // Only save no-empty gateway transaction ids.
        if ($this->subscriptionComplete->gatewayTransactionId) {
            $this->donation->gatewayTransactionId = $this->subscriptionComplete->gatewayTransactionId;
            $this->subscription->transactionId = $this->subscriptionComplete->gatewayTransactionId;
        }

        $this->donation->save();
        $this->subscription->save();
    }
}
PK     —[ÏVª¦È  È  *  CommandHandlers/RedirectOffsiteHandler.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\CommandHandlers;

use Give\Framework\Http\Response\Types\RedirectResponse;
use Give\Framework\PaymentGateways\Commands\RedirectOffsite;

use function Give\Framework\Http\Response\response;

class RedirectOffsiteHandler  {
    /**
     * @since 2.18.0
     */
    public function __invoke(RedirectOffsite $command): RedirectResponse
    {
        return response()->redirectTo($command->redirectUrl);
    }
}
PK     —[+ ï†  †    Traits/HasRouteMethods.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Traits;

use Give\Framework\Exceptions\Primitives\Exception;
use Give\Framework\PaymentGateways\Exceptions\PaymentGatewayException;
use Give\Framework\PaymentGateways\SubscriptionModule;

/**
 * @since 2.20.0
 * @property SubscriptionModule $subscriptionModule
 * @property array $routeMethods
 * @property array $secureRouteMethods
 */
trait HasRouteMethods
{
    /**
     * Route methods are used to extend the gateway api.
     * By adding a custom routeMethod, you are effectively
     * registering a new public route url that will resolve itself and
     * call your method.
     *
     * @var string[]
     */
    public $routeMethods = [];

    /**
     * Secure Route methods are used to extend the gateway api with an additional wp_nonce.
     * By adding a custom secureRouteMethod, you are effectively
     * registering a new route url that will resolve itself and
     * call your method after validating the nonce.
     *
     * @var string[]
     */
    public $secureRouteMethods = [];

    /**
     * @since 2.20.0
     *
     * @param string $method
     *
     * @return bool
     */
    public function supportsMethodRoute($method)
    {
        $allGatewayMethods = array_merge($this->routeMethods, $this->secureRouteMethods);

        return in_array($method, $allGatewayMethods, true);
    }

    /**
     * @since 2.20.0
     *
     * @param string $method
     *
     * @throws Exception
     */
    public function callRouteMethod($method, $queryParams)
    {
        if ($this->supportsMethodRoute($method)) {
            return $this->$method($queryParams);
        }

        throw new PaymentGatewayException(
            sprintf(
                '%1$s route method is not supported by %2$s and %3$s',
                $method,
                get_class($this),
                get_class($this->subscriptionModule)
            )
        );
    }
}
PK     —[0´\      Traits/HandleHttpResponses.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Traits;

use Give\Framework\Http\Response\Types\JsonResponse;
use Give\Framework\Http\Response\Types\RedirectResponse;
use Give\Framework\PaymentGateways\Exceptions\PaymentGatewayException;

trait HandleHttpResponses
{
    /**
     * Handle Response
     *
     * @since 2.27.0 add support for json content-type
     * @since 2.18.0
     *
     * @param  RedirectResponse|JsonResponse  $type
     */
    public function handleResponse($type)
    {
        if ($type instanceof RedirectResponse) {
            if (isset($_SERVER['CONTENT_TYPE']) && str_contains($_SERVER['CONTENT_TYPE'], "application/json")) {
                wp_send_json([
                    'type' => 'redirect',
                    'data' => [
                        'redirectUrl' => $type->getTargetUrl()
                    ]
                ]);
            }

            wp_redirect($type->getTargetUrl());
            exit;
        }

        if ($type instanceof JsonResponse) {
            wp_send_json(['data' => $type->getData()]);
        }
    }

    /**
     * Handle response on basis of request mode when exception occurs:
     * 1. Redirect to donation form if donation form submit.
     * 2. Return json response if processing payment on ajax.
     *
     * @since 2.21.0 Handle PHP exception.
     * @since 2.19.0
     */
    public function handleExceptionResponse(\Exception $exception, string $message)
    {
        if ($exception instanceof PaymentGatewayException) {
            $message = $exception->getMessage();
        }

        if (wp_doing_ajax()) {
            $response = new JsonResponse($message);

            $this->handleResponse($response);
        }

        give_set_error('PaymentGatewayException', $message);
        give_send_back_to_checkout();
    }
}
PK     —[¾Ï‰¹   ¹      Exceptions/OverflowException.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Exceptions;

use Give\Framework\Exceptions\Primitives\Exception;

/**
 * @since 2.18.0
 */
class OverflowException extends Exception
{
}
PK     —[<´[:  :  &  Exceptions/PaymentGatewayException.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Exceptions;

use Give\Framework\Exceptions\Primitives\Exception;

/**
 * @since 2.18.0
 */
class PaymentGatewayException extends Exception
{
    /**
     * @param  string  $message  - a human readable error message
     * @param  int  $code  [optional] The Exception code.
     * @param  null  $previous  [optional] The previous throwable used for the exception chaining.
     */
    public function __construct($message, $code = 0, $previous = null)
    {
        parent::__construct($message, $code, $previous);
    }
}
PK     —[Ýb»e‚	  ‚	  -  Controllers/GatewaySubscriptionController.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Controllers;

use Give\Donations\Models\Donation;
use Give\Framework\Exceptions\Primitives\Exception;
use Give\Framework\FieldsAPI\Exceptions\TypeNotSupported;
use Give\Framework\PaymentGateways\Actions\HandleGatewaySubscriptionCommand;
use Give\Framework\PaymentGateways\Commands\GatewayCommand;
use Give\Framework\PaymentGateways\Log\PaymentGatewayLog;
use Give\Framework\PaymentGateways\PaymentGateway;
use Give\Framework\PaymentGateways\Traits\HandleHttpResponses;
use Give\Subscriptions\Models\Subscription;

/**
 * @since 2.27.0
 */
class GatewaySubscriptionController
{
    use HandleHttpResponses;

    /**
     * @var PaymentGateway
     */
    protected $gateway;

    /**
     * @since 2.27.0
     */
    public function __construct(PaymentGateway $gateway)
    {
        $this->gateway = $gateway;
    }

    /**
     * @since 2.27.0
     */
    public function create(Donation $donation, Subscription $subscription, array $gatewayData = [])
    {
        try {
            $command = $this->gateway->createSubscription($donation, $subscription, $gatewayData);
            $this->handleGatewayCommand($command, $donation, $subscription);
        } catch (\Exception $exception) {
            PaymentGatewayLog::error(
                $exception->getMessage(),
                [
                    'Payment Gateway' => $this->gateway::id(),
                    'Donation' => $donation->toArray(),
                    'Subscription' => $subscription->toArray(),
                ]
            );

            $message = __(
                'An unexpected error occurred while processing the subscription.  Please try again or contact the site administrator.',
                'give'
            );

            $this->handleExceptionResponse($exception, $message);
        }
    }

    /**
     * Handle gateway subscription command
     *
     * @since 2.27.0 move logic into action
     * @since 2.26.0 add RespondToBrowser command
     * @since 2.21.0 Handle RedirectOffsite response.
     * @since 2.18.0
     *
     * @throws TypeNotSupported
     * @throws Exception
     */
    public function handleGatewayCommand(
        GatewayCommand $command,
        Donation $donation,
        Subscription $subscription
    ) {
        $response = (new HandleGatewaySubscriptionCommand())($command, $donation, $subscription);

        $this->handleResponse($response);
    }
}
PK     —[XÙKw  w  (  Controllers/GatewayPaymentController.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Controllers;

use Give\Donations\Models\Donation;
use Give\Framework\Exceptions\Primitives\Exception;
use Give\Framework\FieldsAPI\Exceptions\TypeNotSupported;
use Give\Framework\PaymentGateways\Actions\HandleGatewayPaymentCommand;
use Give\Framework\PaymentGateways\Commands\GatewayCommand;
use Give\Framework\PaymentGateways\Log\PaymentGatewayLog;
use Give\Framework\PaymentGateways\PaymentGateway;
use Give\Framework\PaymentGateways\Traits\HandleHttpResponses;

/**
 * @since 2.27.0
 */
class GatewayPaymentController
{
    use HandleHttpResponses;

    /**
     * @var PaymentGateway
     */
    protected $gateway;

    /**
     * @since 2.27.0
     */
    public function __construct(PaymentGateway $gateway)
    {
        $this->gateway = $gateway;
    }

    /**
     * @since 2.27.0
     */
    public function create(Donation $donation, array $gatewayData = [])
    {
        try {
            $command = $this->gateway->createPayment($donation, $gatewayData);
            $this->handleGatewayCommand($command, $donation);
        } catch (\Exception $exception) {
            PaymentGatewayLog::error(
                $exception->getMessage(),
                [
                    'Payment Gateway' => $this->gateway::id(),
                    'Donation' => $donation->toArray(),
                ]
            );

            $message = __(
                'An unexpected error occurred while processing the donation.  Please try again or contact a site administrator.',
                'give'
            );

            $this->handleExceptionResponse($exception, $message);
        }
    }

    /**
     * @since 2.29.0
     */
    public function refund(Donation $donation)
    {
        try {
            $command = $this->gateway->refundDonation($donation);

            if ($command instanceof GatewayCommand) {
                $this->handleGatewayCommand($command, $donation);
            }
        } catch (\Exception $exception) {
            PaymentGatewayLog::error(
                $exception->getMessage(),
                [
                    'Payment Gateway' => $this->gateway::id(),
                    'Donation' => $donation->toArray(),
                ]
            );

            $message = __(
                'An unexpected error occurred while refunding the donation.  Please try again or contact a site administrator.',
                'give'
            );

            $this->handleExceptionResponse($exception, $message);
        }
    }

    /**
     * Handle gateway command
     *
     * @since 2.27.0 move logic into action
     * @since 2.18.0
     *
     * @throws TypeNotSupported
     * @throws Exception
     */
    protected function handleGatewayCommand(GatewayCommand $command, Donation $donation)
    {
        $response = (new HandleGatewayPaymentCommand())($command, $donation);

        $this->handleResponse($response);
    }
}
PK     —[_8…?  ?    SubscriptionModule.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways;

use Give\Framework\PaymentGateways\Contracts\Subscription\SubscriptionAmountEditable;
use Give\Framework\PaymentGateways\Contracts\Subscription\SubscriptionDashboardLinkable;
use Give\Framework\PaymentGateways\Contracts\Subscription\SubscriptionPaymentMethodEditable;
use Give\Framework\PaymentGateways\Contracts\Subscription\SubscriptionTransactionsSynchronizable;
use Give\Framework\PaymentGateways\Contracts\SubscriptionModuleInterface;
use Give\Framework\PaymentGateways\Traits\HasRouteMethods;

/**
 * @since 2.20.0
 *
 * @template G
 */
abstract class SubscriptionModule implements SubscriptionModuleInterface
{
    use HasRouteMethods;

    /**
     * @var G
     */
    protected $gateway;

    /**
     * @param G $gateway
     */
    public function setGateway(PaymentGateway $gateway)
    {
        $this->gateway = $gateway;
    }

    /**
     * @inheritDoc
     */
    public function canSyncSubscriptionWithPaymentGateway(): bool
    {
        return $this instanceof SubscriptionTransactionsSynchronizable;
    }

    /**
     * @inheritDoc
     */
    public function canUpdateSubscriptionAmount(): bool
    {
        return $this instanceof SubscriptionAmountEditable;
    }

    /**
     * @inheritDoc
     */
    public function canUpdateSubscriptionPaymentMethod(): bool
    {
        return $this instanceof SubscriptionPaymentMethodEditable;
    }

    /**
     * @since 2.21.2
     */
    public function hasGatewayDashboardSubscriptionUrl(): bool
    {
        return $this instanceof SubscriptionDashboardLinkable;
    }
}
PK     —[¹ï¡  ¡  (  DataTransferObjects/GatewayRouteData.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\DataTransferObjects;

/**
 * Class GatewayRouteData
 * @since      2.18.0
 * @since 2.23.1 Make class final to avoid unsafe usage of `new static()`.
 */
final class GatewayRouteData
{
    /**
     * @var string
     */
    public $gatewayId;
    /**
     * @var string
     */
    public $gatewayMethod;
    /**
     * @var array
     */
    public $queryParams;
    /**
     * @var string|null
     */
    public $routeSignature;
    /**
     * @var string|null
     */
    public $routeSignatureId;
    /**
     * @var string|null
     */
    public $routeSignatureExpiration;

    /**
     * Convert data from request into DTO
     *
     * @since 2.19.5 add routeSignatureExpiration
     * @since 2.19.4 add give-route-signature-id
     * @since 2.18.0
     *
     * @return self
     */
    public static function fromRequest(array $request)
    {
        $self = new static();

        $self->gatewayId = $request['give-gateway-id'];
        $self->gatewayMethod = $request['give-gateway-method'];
        $self->routeSignature = isset($request['give-route-signature']) ? $request['give-route-signature'] : null;
        $self->routeSignatureId = isset($request['give-route-signature-id']) ? $request['give-route-signature-id'] : null;
        $self->routeSignatureExpiration = isset($request['give-route-signature-expiration']) ? $request['give-route-signature-expiration'] : null;

        $self->queryParams = array_filter($request, static function ($param) {
            return ! in_array(
                $param,
                [
                    'give-listener',
                    'give-gateway-id',
                    'give-gateway-method',
                    'give-route-signature',
                    'give-route-signature-id',
                    'give-route-signature-expiration',
                ]
            );
        }, ARRAY_FILTER_USE_KEY);

        return $self;
    }
}
PK     —["±¢uk(  k(    PaymentGateway.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways;

use Give\Donations\Models\Donation;
use Give\Framework\Exceptions\Primitives\Exception;
use Give\Framework\PaymentGateways\Actions\GenerateGatewayRouteUrl;
use Give\Framework\PaymentGateways\Contracts\PaymentGatewayInterface;
use Give\Framework\PaymentGateways\Contracts\Subscription\SubscriptionAmountEditable;
use Give\Framework\PaymentGateways\Contracts\Subscription\SubscriptionDashboardLinkable;
use Give\Framework\PaymentGateways\Contracts\Subscription\SubscriptionPaymentMethodEditable;
use Give\Framework\PaymentGateways\Contracts\Subscription\SubscriptionTransactionsSynchronizable;
use Give\Framework\PaymentGateways\Routes\RouteSignature;
use Give\Framework\PaymentGateways\Traits\HandleHttpResponses;
use Give\Framework\PaymentGateways\Traits\HasRouteMethods;
use Give\Framework\Support\ValueObjects\Money;
use Give\Log\Log;
use Give\Subscriptions\Models\Subscription;
use ReflectionException;
use ReflectionMethod;

/**
 * @since 2.30.0 added enqueueScript() and formSettings() methods.
 * @since 2.18.0
 */
abstract class PaymentGateway implements PaymentGatewayInterface,
                                         SubscriptionDashboardLinkable,
                                         SubscriptionAmountEditable,
                                         SubscriptionPaymentMethodEditable,
                                         SubscriptionTransactionsSynchronizable
{
    use HandleHttpResponses;
    use HasRouteMethods {
        supportsMethodRoute as protected SupportsOwnMethodRoute;
        callRouteMethod as protected CallOwnRouteMethod;
    }

    /**
     * @since 2.20.0 Change variable type to SubscriptionModule.
     * @var SubscriptionModule $subscriptionModule
     */
    public $subscriptionModule;

    /**
     * @since 2.20.0 Change first argument type to SubscriptionModule abstract class.
     * @since 2.18.0
     *
     * @param  SubscriptionModule|null  $subscriptionModule
     */
    public function __construct(SubscriptionModule $subscriptionModule = null)
    {
        if ($subscriptionModule !== null) {
            $subscriptionModule->setGateway($this);
        }

        $this->subscriptionModule = $subscriptionModule;
    }

    /**
     * @since 2.30.0
     */
    public function supportsFormVersions(): array
    {
        $versions = [];

        if (method_exists($this, 'getLegacyFormFieldMarkup') && $this->isFunctionImplementedInGatewayClass(
                'getLegacyFormFieldMarkup'
            )) {
            $versions[] = 2;
        }

        if (method_exists($this, 'enqueueScript') && $this->isFunctionImplementedInGatewayClass('enqueueScript')) {
            $versions[] = 3;
        }

        return $versions;
    }

    /**
     * Enqueue gateway scripts using WordPress wp_enqueue_script().
     *
     * @since 2.30.0
     *
     * @return void
     */
    public function enqueueScript(int $formId)
    {
        //wp_enqueue_scripts();
    }

    /**
     * Convenient way of localizing data to the JS gateway object accessible from `this.settings`.
     *
     * @since 2.30.0
     */
    public function formSettings(int $formId): array
    {
        return [];
    }

    /**
     * @inheritDoc
     *
     * @since 2.29.0
     */
    public function supportsRefund(): bool
    {
        return $this->isFunctionImplementedInGatewayClass('refundDonation');
    }

    /**
     * @inheritDoc
     */
    public function supportsSubscriptions(): bool
    {
        return isset($this->subscriptionModule) || $this->isFunctionImplementedInGatewayClass('createSubscription');
    }

    /**
     * If a subscription module isn't wanted this method can be overridden by a child class instead.
     * Just make sure to override the supportsSubscriptions method as well.
     *
     * @inheritDoc
     */
    public function createSubscription(
        Donation $donation,
        Subscription $subscription,
        $gatewayData
    ) {
        return $this->subscriptionModule->createSubscription($donation, $subscription, $gatewayData);
    }

    /**
     * @inheritDoc
     */
    public function cancelSubscription(Subscription $subscription)
    {
        $this->subscriptionModule->cancelSubscription($subscription);
    }

    /**
     * @since 2.21.2
     * @inheritDoc
     */
    public function canSyncSubscriptionWithPaymentGateway(): bool
    {
        if ($this->subscriptionModule) {
            return $this->subscriptionModule->canSyncSubscriptionWithPaymentGateway();
        }

        return $this->isFunctionImplementedInGatewayClass('synchronizeSubscription');
    }

    /**
     * @since 2.21.2
     * @inheritDoc
     */
    public function canUpdateSubscriptionAmount(): bool
    {
        if ($this->subscriptionModule) {
            return $this->subscriptionModule->canUpdateSubscriptionAmount();
        }

        return $this->isFunctionImplementedInGatewayClass('updateSubscriptionAmount');
    }

    /**
     * @since 2.21.2
     * @inheritDoc
     */
    public function canUpdateSubscriptionPaymentMethod(): bool
    {
        if ($this->subscriptionModule) {
            return $this->subscriptionModule->canUpdateSubscriptionPaymentMethod();
        }

        return $this->isFunctionImplementedInGatewayClass('updateSubscriptionPaymentMethod');
    }

    /**
     * @since 2.25.0 update return logic
     * @since 2.21.2
     */
    public function hasGatewayDashboardSubscriptionUrl(): bool
    {
        if ($this->subscriptionModule) {
            return $this->subscriptionModule->hasGatewayDashboardSubscriptionUrl();
        }

        return $this->isFunctionImplementedInGatewayClass('gatewayDashboardSubscriptionUrl');
    }

    /**
     * @since 2.21.2
     * @inheritDoc
     * @throws Exception
     */
    public function synchronizeSubscription(Subscription $subscription)
    {
        if ($this->subscriptionModule instanceof SubscriptionTransactionsSynchronizable) {
            $this->subscriptionModule->synchronizeSubscription($subscription);

            return;
        }

        throw new Exception('Gateway does not support syncing subscriptions.');
    }

    /**
     * @since 2.21.2
     * @inheritDoc
     * @throws Exception
     */
    public function updateSubscriptionAmount(Subscription $subscription, Money $newRenewalAmount)
    {
        if ($this->subscriptionModule instanceof SubscriptionAmountEditable) {
            $this->subscriptionModule->updateSubscriptionAmount($subscription, $newRenewalAmount);

            return;
        }

        throw new Exception('Gateway does not support updating the subscription amount.');
    }

    /**
     * @since 2.21.2
     * @inheritDoc
     * @throws Exception
     */
    public function updateSubscriptionPaymentMethod(Subscription $subscription, $gatewayData)
    {
        if ($this->subscriptionModule instanceof SubscriptionPaymentMethodEditable) {
            $this->subscriptionModule->updateSubscriptionPaymentMethod($subscription, $gatewayData);

            return;
        }

        throw new Exception('Gateway does not support updating the subscription payment method.');
    }

    /**
     * @since 2.21.2
     * @inheritDoc
     */
    public function gatewayDashboardSubscriptionUrl(Subscription $subscription): string
    {
        if ($this->subscriptionModule instanceof SubscriptionDashboardLinkable) {
            return $this->subscriptionModule->gatewayDashboardSubscriptionUrl($subscription);
        }

        return false;
    }

    /**
     * Generate gateway route url
     *
     * @since 2.18.0
     * @since 2.19.0 remove $donationId param in favor of args
     */
    public function generateGatewayRouteUrl(string $gatewayMethod, array $args = []): string
    {
        return (new GenerateGatewayRouteUrl())(static::id(), $gatewayMethod, $args);
    }

    /**
     * Generate secure gateway route url
     *
     * @since 2.19.5 replace nonce with hash and expiration
     * @since 2.19.4 replace RouteSignature args with unique donationId
     * @since 2.19.0
     */
    public function generateSecureGatewayRouteUrl(string $gatewayMethod, int $donationId, array $args = []): string
    {
        $signature = new RouteSignature(static::id(), $gatewayMethod, $donationId);

        return (new GenerateGatewayRouteUrl())(
            static::id(),
            $gatewayMethod,
            array_merge($args, [
                'give-route-signature' => $signature->toHash(),
                'give-route-signature-id' => $donationId,
                'give-route-signature-expiration' => $signature->expiration,
            ])
        );
    }

    /**
     * @since 2.20.0
     */
    public function supportsMethodRoute(string $method): bool
    {
        if ($this->subscriptionModule && $this->subscriptionModule->supportsMethodRoute($method)) {
            return true;
        }

        return $this->supportsOwnMethodRoute($method);
    }

    /**
     * @since 2.20.0
     *
     * @param string $method
     *
     * @throws Exception
     */
    public function callRouteMethod($method, $queryParams)
    {
        if ($this->subscriptionModule && $this->subscriptionModule->supportsMethodRoute($method)) {
            return $this->subscriptionModule->callRouteMethod($method, $queryParams);
        }

        return $this->callOwnRouteMethod($method, $queryParams);
    }

    /**
     * Checks to see if the provided method is being used by the child gateway class. This is used as a helper in the "can" methods
     * to see if the gateway is implementing a recurring feature without using a subscription module.
     *
     * @since 2.21.2
     */
    private function isFunctionImplementedInGatewayClass(string $methodName): bool
    {
        try {
            $reflector = new ReflectionMethod($this, $methodName);
        } catch (ReflectionException $e) {
            Log::error(
                sprintf(
                    'ReflectionException thrown when trying to check if %s::%s is implemented in the gateway class.',
                    static::id(),
                    $methodName
                ),
                [
                    'exception' => $e,
                ]
            );
            return false;
        }

        return ($reflector->getDeclaringClass()->getName() === get_class($this));
    }
}
PK     —[ñH‘žÔ  Ô    PaymentGatewayRegister.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways;

use Give\Container\Container;
use Give\Framework\Exceptions\Primitives\Exception;
use Give\Framework\Exceptions\Primitives\InvalidArgumentException;
use Give\Framework\PaymentGateways\Contracts\PaymentGatewaysIterator;
use Give\Framework\PaymentGateways\Exceptions\OverflowException;

/**
 * @since 2.18.0
 */
class PaymentGatewayRegister extends PaymentGatewaysIterator
{
    /**
     * @var string[]
     */
    protected $gateways = [];

    /**
     * Get Gateways
     *
     * @since 2.30.0 added $supportedFormVersion param to filter gateways by supported form version
     * @since 2.18.0
     */
    public function getPaymentGateways(int $supportedFormVersion = null): array
    {
        if (!$supportedFormVersion) {
            return $this->gateways;
        }

        return array_filter($this->gateways, static function (string $gatewayClass) use ($supportedFormVersion) {
            /** @var PaymentGateway $gateway */
            $gateway = give($gatewayClass);

            return in_array($supportedFormVersion, $gateway->supportsFormVersions(), true);
        });
    }

    /**
     * Get Gateway
     *
     * @since 2.18.0
     */
    public function getPaymentGateway(string $id): PaymentGateway
    {
        if (!$this->hasPaymentGateway($id)) {
            throw new InvalidArgumentException("No gateway exists with the ID {$id}");
        }

        /** @var PaymentGateway $gateway */
        $gateway = give($this->gateways[$id]);

        return $gateway;
    }

    /**
     * @since 2.18.0
     */
    public function hasPaymentGateway(string $id): bool
    {
        return isset($this->gateways[$id]);
    }

    /**
     * Register Gateway
     *
     * @since 2.18.0
     *
     * @throws OverflowException|InvalidArgumentException|Exception
     */
    public function registerGateway(string $gatewayClass)
    {
        if (!is_subclass_of($gatewayClass, PaymentGateway::class)) {
            throw new InvalidArgumentException(
                sprintf(
                    '%1$s must extend %2$s',
                    $gatewayClass,
                    PaymentGateway::class
                )
            );
        }

        $gatewayId = $gatewayClass::id();

        if ($this->hasPaymentGateway($gatewayId)) {
            throw new OverflowException("Cannot register a gateway with an id that already exists: $gatewayId");
        }


        $this->gateways[$gatewayId] = $gatewayClass;


        $this->registerGatewayWithServiceContainer($gatewayClass, $gatewayId);
    }

    /**
     * Unregister Gateway
     *
     * @since 2.18.0
     *
     * @param $gatewayId
     */
    public function unregisterGateway($gatewayId)
    {
        if (isset($this->gateways[$gatewayId])) {
            unset($this->gateways[$gatewayId]);
        }
    }

    /**
     *
     * Register Gateway with Service Container as Singleton
     * with option of adding Subscription Module through filter "give_gateway_{$gatewayId}_subscription_module"
     *
     * @since 2.18.0
     *
     * @return void
     */
    private function registerGatewayWithServiceContainer(string $gatewayClass, string $gatewayId)
    {
        give()->singleton($gatewayClass, function (Container $container) use ($gatewayClass, $gatewayId) {
            $subscriptionModule = apply_filters("givewp_gateway_{$gatewayId}_subscription_module", null);

            return new $gatewayClass($subscriptionModule ? $container->make($subscriptionModule) : null);
        });
    }
}
PK     —[[¥4ö4  4    Log/PaymentGatewayLog.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways\Log;

use Give\Donations\Models\Donation;
use Give\Log\Log;

/**
 * @since 2.21.0 Remove GatewayPaymentData related code and Update 'source' to payment gateway name
 * @since 2.19.6 remove cardInfo from log
 * @since 2.18.0
 */
class PaymentGatewayLog extends Log
{
    /**
     * @inheritDoc
     */
    public static function __callStatic($name, $arguments)
    {
        $arguments[1]['category'] = 'Payment Gateway';
        $arguments[1]['source'] = 'Payment Gateway';

        if (
            array_key_exists('Donation', $arguments[1]) &&
            $arguments[1]['Donation'] instanceof Donation
        ) {
            $arguments[1]['source'] = $arguments[1]['Donation']->gateway()->getName();
        }

        parent::__callStatic($name, $arguments);
    }
}
PK     —[¦ò—ía
  a
    DonationSummary.phpnu „[µü¤        <?php

namespace Give\Framework\PaymentGateways;

use Give\Donations\Models\Donation;

/**
 * @since 2.19.0
 */
class DonationSummary
{
    /** @var int */
    protected $length = 255;

    /** @var Donation */
    protected $donation;

    /**
     * @since 2.19.0
     */
    public function __construct(Donation $donation)
    {
        $this->donation = $donation;
    }

    /**
     * @since 2.19.0
     *
     * @param int $length
     */
    public function setLength(int $length)
    {
        $this->length = $length;
    }

    /**
     * @since 2.19.0
     *
     * @return string
     */
    public function getSummaryWithDonor(): string
    {
        return $this->trim(
            implode(' - ', [
                $this->getSummary(),
                $this->getDonorLabel(),
            ])
        );
    }

    /**
     * @since 2.19.0
     *
     * @return string
     */
    public function getSummary(): string
    {
        return $this->trimAndFilter(
            implode(
                ': ',
                array_filter([
                    $this->getLabel(),
                    $this->getPriceLabel(),
                ])
            )
        );
    }

    /**
     * @since 2.19.0
     *
     * @return string
     */
    protected function getLabel(): string
    {
        $formId = give_get_payment_form_id($this->donation->id);
        $formTitle = get_the_title($formId);
        return $formTitle ?: sprintf(__('Donation Form ID: %d', 'give'), $formId);
    }

    /**
     * @since 2.19.0
     * @return string
     */
    protected function getPriceLabel(): string
    {
        $priceId = $this->donation->levelId;

        return is_numeric($priceId)
            ? give_get_price_option_name($this->donation->formId, $this->donation->levelId)
            : '';
    }

    /**
     * @since 2.19.0
     */
    protected function getDonorLabel(): string
    {
        return sprintf(
            '%s %s (%s)',
            $this->donation->firstName,
            $this->donation->lastName,
            $this->donation->email
        );
    }

    /**
     * @since 2.19.0
     *
     * @param string $text
     *
     * @return string
     */
    protected function trimAndFilter(string $text): string
    {
        /**
         * @since 2.25.0 Re-use trim method for text.
         * @since 1.8.12
         */
        return apply_filters('give_payment_gateway_donation_summary', $this->trim($text));
    }

    /**
     * @since 2.25.0
     *
     * @param string $text
     *
     * @return string
     */
    protected function trim(string $text): string
    {
        return substr($text, 0, $this->length);
    }
}
PK       —[¬â„…   …                   Commands/PaymentComplete.phpnu „[µü¤        PK       —[RDDwr   r               Ñ   Commands/GatewayCommand.phpnu „[µü¤        PK       —[k'¨Ž  Ž  !            Ž  Commands/SubscriptionComplete.phpnu „[µü¤        PK       —[Ö² ½‡   ‡               m  Commands/PaymentProcessing.phpnu „[µü¤        PK       —[ÜsÙPA  A              B  Commands/RespondToBrowser.phpnu „[µü¤        PK       —[h(ðV…   …               Ð  Commands/PaymentRefunded.phpnu „[µü¤        PK       —[Ý+f­  ­  #            ¡  Commands/SubscriptionProcessing.phpnu „[µü¤        PK       —[F¡z—W  W              ¡
  Commands/RedirectOffsite.phpnu „[µü¤        PK       —[øi¢                D  Commands/PaymentCommand.phpnu „[µü¤        PK       —[Ç0B6†   †               –  Commands/PaymentAbandoned.phpnu „[µü¤        PK       —[0
ßß  ß  <            i  Contracts/Subscription/SubscriptionPaymentMethodEditable.phpnu „[µü¤        PK       —[v}Ä6Ý  Ý  5            ´  Contracts/Subscription/SubscriptionAmountEditable.phpnu „[µü¤        PK       —[³î)Lƒ  ƒ  A            ö  Contracts/Subscription/SubscriptionTransactionsSynchronizable.phpnu „[µü¤        PK       —[¾-Ë	9  9  8            ê  Contracts/Subscription/SubscriptionDashboardLinkable.phpnu „[µü¤        PK       —[ôB)¿  ¿  %            ‹  Contracts/PaymentGatewaysIterator.phpnu „[µü¤        PK       —[£ö°  °  %            Ÿ   Contracts/PaymentGatewayInterface.phpnu „[µü¤        PK       —[ž>    )            ¤,  Contracts/SubscriptionModuleInterface.phpnu „[µü¤        PK       —["M	  M	  ,            Œ3  Actions/HandleGatewaySubscriptionCommand.phpnu „[µü¤        PK       —[y`Ÿ†,  ,  #            5=  Actions/GenerateGatewayRouteUrl.phpnu „[µü¤        PK       —[ çÊn
  n
  '            ´@  Actions/HandleGatewayPaymentCommand.phpnu „[µü¤        PK       —[iÙ1wÁ  Á              yK  Routes/GatewayRoute.phpnu „[µü¤        PK       —[œym®	  	              b  Routes/RouteSignature.phpnu „[µü¤        PK       —[^\8  8  *            Ìk  CommandHandlers/PaymentCompleteHandler.phpnu „[µü¤        PK       —[2ffq;  ;  +            ^n  CommandHandlers/PaymentAbandonedHandler.phpnu „[µü¤        PK       —[½;ê<K  K  ,            ôp  CommandHandlers/PaymentProcessingHandler.phpnu „[µü¤        PK       —[š÷q<$  $  /            ›s  CommandHandlers/SubscriptionCompleteHandler.phpnu „[µü¤        PK       —[Î¡®6  6  *            x  CommandHandlers/PaymentRefundedHandler.phpnu „[µü¤        PK       —[àßÛ¶  ¶  +            ®z  CommandHandlers/RespondToBrowserHandler.phpnu „[µü¤        PK       —[5AÞõ  õ  "            ¿|  CommandHandlers/PaymentHandler.phpnu „[µü¤        PK       —[Ö²Äþ  þ  1            ƒ  CommandHandlers/SubscriptionProcessingHandler.phpnu „[µü¤        PK       —[ÏVª¦È  È  *            eŠ  CommandHandlers/RedirectOffsiteHandler.phpnu „[µü¤        PK       —[+ ï†  †              ‡Œ  Traits/HasRouteMethods.phpnu „[µü¤        PK       —[0´\                W”  Traits/HandleHttpResponses.phpnu „[µü¤        PK       —[¾Ï‰¹   ¹                ¿›  Exceptions/OverflowException.phpnu „[µü¤        PK       —[<´[:  :  &            Èœ  Exceptions/PaymentGatewayException.phpnu „[µü¤        PK       —[Ýb»e‚	  ‚	  -            XŸ  Controllers/GatewaySubscriptionController.phpnu „[µü¤        PK       —[XÙKw  w  (            7©  Controllers/GatewayPaymentController.phpnu „[µü¤        PK       —[_8…?  ?              µ  SubscriptionModule.phpnu „[µü¤        PK       —[¹ï¡  ¡  (            ‹»  DataTransferObjects/GatewayRouteData.phpnu „[µü¤        PK       —["±¢uk(  k(              „Ã  PaymentGateway.phpnu „[µü¤        PK       —[ñH‘žÔ  Ô              1ì  PaymentGatewayRegister.phpnu „[µü¤        PK       —[[¥4ö4  4              Oú  Log/PaymentGatewayLog.phpnu „[µü¤        PK       —[¦ò—ía
  a
              Ìý  DonationSummary.phpnu „[µü¤        PK    + + Ô  p   