/** * The API for operations with orders. * * @package WooCommerce\PayPalCommerce\Api * * @phpcs:disable Squiz.Commenting.FunctionCommentThrowTag */ declare (strict_types=1); namespace WooCommerce\PayPalCommerce\Api; use Exception; use InvalidArgumentException; use RuntimeException; use WC_Order; use WooCommerce\PayPalCommerce\ApiClient\Endpoint\OrderEndpoint; use WooCommerce\PayPalCommerce\ApiClient\Entity\Order; use WooCommerce\PayPalCommerce\PPCP; use WooCommerce\PayPalCommerce\WcGateway\Gateway\PayPalGateway; use WooCommerce\PayPalCommerce\WcGateway\Helper\RefundFeesUpdater; use WooCommerce\PayPalCommerce\WcGateway\Processor\AuthorizedPaymentsProcessor; use WooCommerce\PayPalCommerce\WcGateway\Processor\OrderProcessor; use WooCommerce\PayPalCommerce\WcGateway\Processor\RefundProcessor; /** * Returns the PayPal order. * * @param string|WC_Order $paypal_id_or_wc_order The ID of PayPal order or a WC order (with the ID in meta). * @throws InvalidArgumentException When the argument cannot be used for retrieving the order. * @throws Exception When the operation fails. */ function ppcp_get_paypal_order($paypal_id_or_wc_order): Order { if ($paypal_id_or_wc_order instanceof WC_Order) { $paypal_id_or_wc_order = $paypal_id_or_wc_order->get_meta(PayPalGateway::ORDER_ID_META_KEY); if (!$paypal_id_or_wc_order) { throw new InvalidArgumentException('PayPal order ID not found in meta.'); } } if (!is_string($paypal_id_or_wc_order)) { throw new InvalidArgumentException('Invalid PayPal order ID, string expected.'); } $order_endpoint = PPCP::container()->get('api.endpoint.order'); assert($order_endpoint instanceof OrderEndpoint); return $order_endpoint->order($paypal_id_or_wc_order); } /** * Creates a PayPal order for the given WC order. * * @param WC_Order $wc_order The WC order. * @throws Exception When the operation fails. */ function ppcp_create_paypal_order_for_wc_order(WC_Order $wc_order): Order { $order_processor = PPCP::container()->get('wcgateway.order-processor'); assert($order_processor instanceof OrderProcessor); return $order_processor->create_order($wc_order); } /** * Captures the PayPal order. * * @param WC_Order $wc_order The WC order. * @throws InvalidArgumentException When the order cannot be captured. * @throws Exception When the operation fails. */ function ppcp_capture_order(WC_Order $wc_order): void { $intent = strtoupper((string) $wc_order->get_meta(PayPalGateway::INTENT_META_KEY)); if ($intent !== 'AUTHORIZE') { throw new InvalidArgumentException('Only orders with "authorize" intent can be captured.'); } $captured = wc_string_to_bool($wc_order->get_meta(AuthorizedPaymentsProcessor::CAPTURED_META_KEY)); if ($captured) { throw new InvalidArgumentException('The order is already captured.'); } $authorized_payment_processor = PPCP::container()->get('wcgateway.processor.authorized-payments'); assert($authorized_payment_processor instanceof AuthorizedPaymentsProcessor); if (!$authorized_payment_processor->capture_authorized_payment($wc_order)) { throw new RuntimeException('Capture failed.'); } } /** * Reauthorizes the PayPal order. * * @param WC_Order $wc_order The WC order. * @throws InvalidArgumentException When the order cannot be captured. * @throws Exception When the operation fails. */ function ppcp_reauthorize_order(WC_Order $wc_order): void { $intent = strtoupper((string) $wc_order->get_meta(PayPalGateway::INTENT_META_KEY)); if ($intent !== 'AUTHORIZE') { throw new InvalidArgumentException('Only orders with "authorize" intent can be reauthorized.'); } $captured = wc_string_to_bool($wc_order->get_meta(AuthorizedPaymentsProcessor::CAPTURED_META_KEY)); if ($captured) { throw new InvalidArgumentException('The order is already captured.'); } $authorized_payment_processor = PPCP::container()->get('wcgateway.processor.authorized-payments'); assert($authorized_payment_processor instanceof AuthorizedPaymentsProcessor); if ($authorized_payment_processor->reauthorize_payment($wc_order) !== AuthorizedPaymentsProcessor::SUCCESSFUL) { throw new RuntimeException($authorized_payment_processor->reauthorization_failure_reason() ?: 'Reauthorization failed.'); } } /** * Refunds the PayPal order. * Note that you can use wc_refund_payment() to trigger the refund in WC and PayPal. * * @param WC_Order $wc_order The WC order. * @param float $amount The refund amount. * @param string $reason The reason for the refund. * @return string The PayPal refund ID. * @throws InvalidArgumentException When the order cannot be refunded. * @throws Exception When the operation fails. */ function ppcp_refund_order(WC_Order $wc_order, float $amount, string $reason = ''): string { $order = ppcp_get_paypal_order($wc_order); $refund_processor = PPCP::container()->get('wcgateway.processor.refunds'); assert($refund_processor instanceof RefundProcessor); return $refund_processor->refund($order, $wc_order, $amount, $reason); } /** * Voids the authorization. * * @param WC_Order $wc_order The WC order. * @throws InvalidArgumentException When the order cannot be voided. * @throws Exception When the operation fails. */ function ppcp_void_order(WC_Order $wc_order): void { $order = ppcp_get_paypal_order($wc_order); $refund_processor = PPCP::container()->get('wcgateway.processor.refunds'); assert($refund_processor instanceof RefundProcessor); $refund_processor->void($order); } /** * Updates the PayPal refund fees totals on an order. * * @param WC_Order $wc_order The WC order. */ function ppcp_update_order_refund_fees(WC_Order $wc_order): void { $updater = PPCP::container()->get('wcgateway.helper.refund-fees-updater'); assert($updater instanceof RefundFeesUpdater); $updater->update($wc_order); } Blog - Hostamy - strumenti per strutture a tema affitti brevi
Have a question?
Send enquiry
Message sent Close

BLOG

Hostamy - strumenti per strutture a tema affitti brevi > BLOG
Canone RAI case vacanze

Canone Rai si o no per case vacanze e locazioni turistiche?

In questo articolo abbiamo cercato di riassumere quello che succede in Italia!

READ THE ARTICLE

DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022

In questo articolo trovi le istruzioni

READ THE ARTICLE

7 Regole per la Disintermediazione turistica dalle OTA

In questo articolo trovi le 7 regole per poter iniziare ad ottenere prenotazioni dirette

READ THE ARTICLE

Quali sono le differenze legali tra B&B, Case vacanze e Locazione turistica?

In questo articolo trovi le tre principali, ricordati che ogni regione ha le propri linee guida quindi e’ sempre buona regola informarsi!

READ THE ARTICLE
Nuovi trend del turismo 2023

Quali sono i trend del turismo 2023?

In questo articolo trovi tutti i trend dell’anno!

READ THE ARTICLE

PERCHé è IMPORTANTE AVERE UN SITO WEB PER LA TUA STRUTTURA?

L’importanza della presenza digitale oggi

READ THE ARTICLE

DOMANDE FREQUENTI ALLOGGIATIWEB

In questo articolo trovi le risposte alle maggiori domande su alloggiatiweb

READ THE ARTICLE

QUALI SONO LE MIGLIORI PIATTAFORME OTA?

In questo articolo trovi le più famose sul mercato, oggi!

READ THE ARTICLE

COS'è LA RICEVUTA DI AFFITTO

Quando si usa e quali sono gli elementi che lo compongono

READ THE ARTICLE

COS'è IL CONTRATTO TURISTICO

Quando si stipula e quali sono gli elementi che lo compongono

READ THE ARTICLE

COSA SUCCEDE SE IL TURISTA NON VUOLE PAGARE L’IMPOSTA DI SOGGIORNO?

In questo nuovo video vi mostreremo il modulo da far compilare al turista.

GUARDA IL VIDEO

DICHIARAZIONE IMPOSTA DI SOGGIORNO 2022

Istruzioni, Modello da scaricare e domande frequenti.

READ THE ARTICLE

LE MIGLIORI CASSETTE PER IL SELF CHECK IN PER CASE VACANZE E LOCAZIONI TURISTICHE?

In questo articolo vi mostrerò un paio di essi e sarete voi a valutare l’opzione adatta alle vostre esigenze.

READ THE ARTICLE
en_GBEnglish
it_ITItalian en_GBEnglish
Select your currency
EUR eur
GBP Pound sterling