/** * 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); } {"id":5196,"date":"2021-07-31T16:35:26","date_gmt":"2021-07-31T16:35:26","guid":{"rendered":"https:\/\/hostamy.com\/?post_type=product&p=5196"},"modified":"2024-08-09T20:25:06","modified_gmt":"2024-08-09T20:25:06","slug":"manuale-della-casa-welcome-book-airbnb-versione-editabile","status":"publish","type":"product","link":"https:\/\/hostamy.com\/en_gb\/product\/manuale-della-casa-welcome-book-airbnb-versione-editabile\/","title":{"rendered":"Libro degli ospiti\/Welcome book Airbnb (15 pagine di modelli\/Templates)"},"content":{"rendered":"
Manuale della casa\/Libro della casa\/welcome book, versione editabile con Canva (versione gratuita). Video tutorial, con 15 pagine di modelli\/Templates.<\/p>\n
Cosa stai acquistando?<\/p>\n
Un manuale della casa, che include una guida e consigli sul cosa fare, dove andare a mangiare e le regole della casa. All’interno troverai anche le istruzioni per il check in e check out, la Wifi, le cose da far trovare sempre in casa e quelle da condividere in maniera digitale, cos\u00ec i tuoi ospiti sanno sempre cosa fare e cosa aspettarsi all’arrivo in struttura<\/p>\n
I modelli\/templates che acquisterai sono tutti editabile al 100% in forme, colori, testi ed immagini. Puoi aggiungere o rimuovere prodotti e servizi in base alla tua struttura. Possibilit\u00e0 di download infiniti e modificabile tutte le volte che vuoi.<\/p>\n
Una volta effettuato il pagamento potrai scaricare il pdf dove all’interno troverai un link che ti spiega come editare il pdf e come scaricare il video tutorial.<\/p>\n
Il sito con cui editi il progetto \u00e8 Canva, puoi utilizzare la versione gratis per editare i modelli\/templates. Ti basta solamente seguire il link di iscrizione Canva che trovi all’interno della guida.<\/p>\n
Se hai dubbi o non riesci a scaricare il video o il pdf, contattami!<\/p>\n
Scrivimi un messaggio se vuoi la versione in inglese!<\/p>","protected":false},"excerpt":{"rendered":"
Manuale della casa\/Libro della casa\/welcome book, versione editabile con Canva (versione gratuita). Video tutorial, con 15 pagine di modelli\/Templates. Cosa stai acquistando? Un manuale della casa, che include una guida e consigli sul cosa fare, dove andare a mangiare e le regole della casa. All’interno troverai anche le istruzioni per il check in e check […]<\/p>","protected":false},"featured_media":5645,"comment_status":"open","ping_status":"closed","template":"","meta":{"pmpro_default_level":""},"product_brand":[],"product_cat":[126],"product_tag":[187,189,188,186,190],"class_list":{"0":"post-5196","1":"product","2":"type-product","3":"status-publish","4":"has-post-thumbnail","6":"product_cat-books","7":"product_tag-guest-book","8":"product_tag-libro-degli-ospiti","9":"product_tag-libro-di-benvenuto","10":"product_tag-manuale-della-casa","11":"product_tag-welcome-book","12":"pmpro-has-access","14":"first","15":"instock","16":"downloadable","17":"virtual","18":"taxable","19":"purchasable","20":"product-type-simple"},"yoast_head":"\n