/**
 * 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);
}
<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>regole della casa e BeB Archives - Hostamy - strumenti per strutture a tema affitti brevi</title>
	<atom:link href="https://hostamy.com/en_gb/product-tag/regole-della-casa-e-beb/feed/" rel="self" type="application/rss+xml" />
	<link>https://hostamy.com/en_gb/product-tag/regole-della-casa-e-beb/</link>
	<description>Blog e prodotti per host di case vacanze, LT e B&#38;B a diventare pi&#249; digitali. Cartelli per la casa, contratto di affitto, Libro degli Ospiti etc.</description>
	<lastbuilddate>Fri, 11 Apr 2025 22:15:40 +0000</lastbuilddate>
	<language>en-GB</language>
	<sy:updateperiod>
	hourly	</sy:updateperiod>
	<sy:updatefrequency>
	1	</sy:updatefrequency>
	<generator>https://wordpress.org/?v=6.8.8</generator>
	<item>
		<title>Regole per Casa vacanze, Locazione Turistiche e B&#038;B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate</title>
		<link>https://hostamy.com/en_gb/product/regole-per-casa-vacanze-e-bb/</link>
					<comments>https://hostamy.com/en_gb/product/regole-per-casa-vacanze-e-bb/#respond</comments>
		
		<dc:creator><![CDATA[admin]]></dc:creator>
		<pubdate>Sat, 31 Jul 2021 16:05:30 +0000</pubdate>
				<guid ispermalink="false">https://hostamy.com/?post_type=product&#038;p=5173</guid>

					<description><![CDATA[<p>Regole per gli ospiti da seguire per Casa vacanze e BeB, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate. Cosa stai acquistando? Si tratta di tutte le regole per la tua casa vacanza, BeB o struttura dedicata alla Locazione turistica. Un brochure con le regole più comuni utilitizzate nel settore affitti brevi. Sono [&#8230;]</p>
<p>The post <a href="https://hostamy.com/en_gb/product/regole-per-casa-vacanze-e-bb/">Regole per Casa vacanze, Locazione Turistiche e B&#038;B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate</a> appeared first on <a href="https://hostamy.com/en_gb">Hostamy - strumenti per strutture a tema affitti brevi</a>.</p>
]]></description>
										<content:encoded><![CDATA[<p>Regole per gli ospiti da seguire per Casa vacanze e BeB, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate.</p>
<p>Cosa stai acquistando?</p>
<p>Si tratta di tutte le regole per la tua casa vacanza, BeB o struttura dedicata alla Locazione turistica. Un brochure con le regole più comuni utilitizzate nel settore affitti brevi.</p>
<p>Sono regole &#8220;pronte all’uso&#8221; quindi una volta acquistato il documento puoi stamparlo e condividere le regole con i tuoi ospiti.</p>
<p>I modelli templates che acquisterai sono editabile al 100% in forme, colori, testi ed immagini. Puoi aggiungere o togliere regole in base alla tua struttura. Possibilità di download infiniti e modificabile tutte le volte che vuoi.</p>
<p>Una volta effettuato il pagamento potrai scaricare il pdf e un foglio extra dove all&#8217;interno troverai un link che ti spiega come editare il pdf (se desideri editare la lista di regole)</p>
<p>Il sito con cui editi il progetto è Canva, puoi utilizzare la versione gratis per editare i modelli/templates. Ti basta solamente seguire il link di iscrizione Canva che trovi all&#8217;interno della guida.</p><p>The post <a href="https://hostamy.com/en_gb/product/regole-per-casa-vacanze-e-bb/">Regole per Casa vacanze, Locazione Turistiche e B&#038;B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate</a> appeared first on <a href="https://hostamy.com/en_gb">Hostamy - strumenti per strutture a tema affitti brevi</a>.</p>
]]></content:encoded>
					
					<wfw:commentrss>https://hostamy.com/en_gb/product/regole-per-casa-vacanze-e-bb/feed/</wfw:commentrss>
			<slash:comments>0</slash:comments>
		
		
			</item>
	</channel>
</rss>