/** * 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":5173,"date":"2021-07-31T16:05:30","date_gmt":"2021-07-31T16:05:30","guid":{"rendered":"https:\/\/hostamy.com\/?post_type=product&p=5173"},"modified":"2025-04-11T22:15:40","modified_gmt":"2025-04-11T22:15:40","slug":"regole-per-casa-vacanze-e-bb","status":"publish","type":"product","link":"https:\/\/hostamy.com\/en_gb\/product\/regole-per-casa-vacanze-e-bb\/","title":{"rendered":"Regole per Casa vacanze, Locazione Turistiche e B&B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate"},"content":{"rendered":"

Regole per gli ospiti da seguire per Casa vacanze e BeB, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate.<\/p>\n

Cosa stai acquistando?<\/p>\n

Si tratta di tutte le regole per la tua casa vacanza, BeB o struttura dedicata alla Locazione turistica. Un brochure con le regole pi\u00f9 comuni utilitizzate nel settore affitti brevi.<\/p>\n

Sono regole “pronte all\u2019uso” quindi una volta acquistato il documento puoi stamparlo e condividere le regole con i tuoi ospiti.<\/p>\n

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\u00e0 di download infiniti e modificabile tutte le volte che vuoi.<\/p>\n

Una volta effettuato il pagamento potrai scaricare il pdf e un foglio extra dove all’interno troverai un link che ti spiega come editare il pdf (se desideri editare la lista di regole)<\/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>","protected":false},"excerpt":{"rendered":"

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\u00f9 comuni utilitizzate nel settore affitti brevi. Sono […]<\/p>","protected":false},"featured_media":5711,"comment_status":"open","ping_status":"closed","template":"","meta":{"pmpro_default_level":""},"product_brand":[],"product_cat":[159],"product_tag":[185,184],"class_list":{"0":"post-5173","1":"product","2":"type-product","3":"status-publish","4":"has-post-thumbnail","6":"product_cat-contratti","7":"product_tag-house-rules","8":"product_tag-regole-della-casa-e-beb","9":"pmpro-has-access","11":"first","12":"instock","13":"downloadable","14":"virtual","15":"taxable","16":"purchasable","17":"product-type-simple"},"yoast_head":"\nRegole per Casa vacanze, Locazione Turistiche e B&B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate - Hostamy - strumenti per strutture a tema affitti brevi<\/title>\n<meta name=\"description\" content=\"Modello delle regole dalla casa da mostrare ai tuoi ospiti e da condividere digitalmente in pdf. Modelli editabili al 100% con video tutorial\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/hostamy.com\/en_gb\/product\/regole-per-casa-vacanze-e-bb\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Regole per Casa vacanze, Locazione Turistiche e B&B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate - Hostamy - strumenti per strutture a tema affitti brevi\" \/>\n<meta property=\"og:description\" content=\"Modello delle regole dalla casa da mostrare ai tuoi ospiti e da condividere digitalmente in pdf. Modelli editabili al 100% con video tutorial\" \/>\n<meta property=\"og:url\" content=\"https:\/\/hostamy.com\/en_gb\/product\/regole-per-casa-vacanze-e-bb\/\" \/>\n<meta property=\"og:site_name\" content=\"Hostamy - strumenti per strutture a tema affitti brevi\" \/>\n<meta property=\"article:modified_time\" content=\"2025-04-11T22:15:40+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/10\/Progetto-senza-titolo-16.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1920\" \/>\n\t<meta property=\"og:image:height\" content=\"1440\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Estimated reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/\",\"url\":\"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/\",\"name\":\"Regole per Casa vacanze, Locazione Turistiche e B&B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate - Hostamy - strumenti per strutture a tema affitti brevi\",\"isPartOf\":{\"@id\":\"https:\/\/hostamy.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/10\/Progetto-senza-titolo-16.png\",\"datePublished\":\"2021-07-31T16:05:30+00:00\",\"dateModified\":\"2025-04-11T22:15:40+00:00\",\"description\":\"Modello delle regole dalla casa da mostrare ai tuoi ospiti e da condividere digitalmente in pdf. Modelli editabili al 100% con video tutorial\",\"breadcrumb\":{\"@id\":\"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/#breadcrumb\"},\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/#primaryimage\",\"url\":\"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/10\/Progetto-senza-titolo-16.png\",\"contentUrl\":\"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/10\/Progetto-senza-titolo-16.png\",\"width\":1920,\"height\":1440},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/hostamy.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Shop degli hosts\",\"item\":\"https:\/\/hostamy.com\/shop-degli-hosts-strumenti-per-strutture-a-tema-affitti-brevi\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Regole per Casa vacanze, Locazione Turistiche e B&B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/hostamy.com\/#website\",\"url\":\"https:\/\/hostamy.com\/\",\"name\":\"Hostamy - strumenti per strutture a tema affitti brevi\",\"description\":\"Blog e prodotti per host di case vacanze, LT e B&B a diventare più digitali. Cartelli per la casa, contratto di affitto, Libro degli Ospiti etc.\",\"publisher\":{\"@id\":\"https:\/\/hostamy.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/hostamy.com\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-GB\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/hostamy.com\/#organization\",\"name\":\"Hostamy - strumenti per strutture a tema affitti brevi\",\"url\":\"https:\/\/hostamy.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/hostamy.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/07\/cropped-1-4-e1627541980492.png\",\"contentUrl\":\"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/07\/cropped-1-4-e1627541980492.png\",\"width\":200,\"height\":200,\"caption\":\"Hostamy - strumenti per strutture a tema affitti brevi\"},\"image\":{\"@id\":\"https:\/\/hostamy.com\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Regole per Casa vacanze, Locazione Turistiche e B&B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate - Hostamy - strumenti per strutture a tema affitti brevi","description":"Modello delle regole dalla casa da mostrare ai tuoi ospiti e da condividere digitalmente in pdf. Modelli editabili al 100% con video tutorial","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/hostamy.com\/en_gb\/product\/regole-per-casa-vacanze-e-bb\/","og_locale":"en_GB","og_type":"article","og_title":"Regole per Casa vacanze, Locazione Turistiche e B&B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate - Hostamy - strumenti per strutture a tema affitti brevi","og_description":"Modello delle regole dalla casa da mostrare ai tuoi ospiti e da condividere digitalmente in pdf. Modelli editabili al 100% con video tutorial","og_url":"https:\/\/hostamy.com\/en_gb\/product\/regole-per-casa-vacanze-e-bb\/","og_site_name":"Hostamy - strumenti per strutture a tema affitti brevi","article_modified_time":"2025-04-11T22:15:40+00:00","og_image":[{"width":1920,"height":1440,"url":"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/10\/Progetto-senza-titolo-16.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Estimated reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/","url":"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/","name":"Regole per Casa vacanze, Locazione Turistiche e B&B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate - Hostamy - strumenti per strutture a tema affitti brevi","isPartOf":{"@id":"https:\/\/hostamy.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/#primaryimage"},"image":{"@id":"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/#primaryimage"},"thumbnailUrl":"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/10\/Progetto-senza-titolo-16.png","datePublished":"2021-07-31T16:05:30+00:00","dateModified":"2025-04-11T22:15:40+00:00","description":"Modello delle regole dalla casa da mostrare ai tuoi ospiti e da condividere digitalmente in pdf. Modelli editabili al 100% con video tutorial","breadcrumb":{"@id":"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/"]}]},{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/#primaryimage","url":"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/10\/Progetto-senza-titolo-16.png","contentUrl":"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/10\/Progetto-senza-titolo-16.png","width":1920,"height":1440},{"@type":"BreadcrumbList","@id":"https:\/\/hostamy.com\/prodotto\/regole-per-casa-vacanze-e-bb\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/hostamy.com\/"},{"@type":"ListItem","position":2,"name":"Shop degli hosts","item":"https:\/\/hostamy.com\/shop-degli-hosts-strumenti-per-strutture-a-tema-affitti-brevi\/"},{"@type":"ListItem","position":3,"name":"Regole per Casa vacanze, Locazione Turistiche e B&B da mostrare agli ospiti in ita ed inglese, versione editabile con Canva (versione gratuita). Video tutorial, stampe illimitate"}]},{"@type":"WebSite","@id":"https:\/\/hostamy.com\/#website","url":"https:\/\/hostamy.com\/","name":"Hostamy - strumenti per strutture a tema affitti brevi","description":"Blog e prodotti per host di case vacanze, LT e B&B a diventare più digitali. Cartelli per la casa, contratto di affitto, Libro degli Ospiti etc.","publisher":{"@id":"https:\/\/hostamy.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/hostamy.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-GB"},{"@type":"Organization","@id":"https:\/\/hostamy.com\/#organization","name":"Hostamy - strumenti per strutture a tema affitti brevi","url":"https:\/\/hostamy.com\/","logo":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/hostamy.com\/#\/schema\/logo\/image\/","url":"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/07\/cropped-1-4-e1627541980492.png","contentUrl":"https:\/\/hostamy.com\/wp-content\/uploads\/2021\/07\/cropped-1-4-e1627541980492.png","width":200,"height":200,"caption":"Hostamy - strumenti per strutture a tema affitti brevi"},"image":{"@id":"https:\/\/hostamy.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/product\/5173","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/product"}],"about":[{"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/types\/product"}],"replies":[{"embeddable":true,"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/comments?post=5173"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/media\/5711"}],"wp:attachment":[{"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/media?parent=5173"}],"wp:term":[{"taxonomy":"product_brand","embeddable":true,"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/product_brand?post=5173"},{"taxonomy":"product_cat","embeddable":true,"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/product_cat?post=5173"},{"taxonomy":"product_tag","embeddable":true,"href":"https:\/\/hostamy.com\/en_gb\/wp-json\/wp\/v2\/product_tag?post=5173"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}