WooCommerce PayPal Checkout Payment Gateway


This is a PayPal Checkout Payment Gateway for WooCommerce.

PayPal Checkout allows you to securely sell your products and subscriptions online using In-Context Checkout to help you meet security requirements without causing your theme to suffer. In-Context Checkout uses a modal window, hosted on PayPal’s servers, that overlays the checkout form and provides a secure means for your customers to enter their account information.

Inoltre, con l’installazione PayPal integrata (Easy Setup), la connessione a PayPal è semplice come fare clic su un pulsante – nessuna chiave API complicata da copiare e incollare.


  • Click the "Setup or link an existing PayPal account" button. If you want to test before going live, you can switch the Environment, above the button, to Sandbox.
  • API credentials will be set after linking, or you can set them manually.
  • See PayPal button settings below.
  • Checkout con PayPal direttamente dal carrello.
  • And without leaving the store.
  • Confirm details after clicking "Continue".
  • Choose PayPal from regular checkout page.
  • Choose PayPal from single product page.
  • Initiate checkout from mini-cart.


Requisiti minimi

  • WordPress 4.4 o superiore

Installazione automatica

L’installazione automatica è l’opzione più facile dato che WordPress stesso gestisce il trasferimento dei file e non hai bisogno di uscire dal tuo browser web. Per effettuare un’installazione automatica, accedi alla tua bacheca WordPress, vai al menu Plugin e fai clic su Aggiungi Nuovo.

In the search field type “WooCommerce PayPal Checkout” and click Search Plugins. Once you’ve found our plugin you can view details about it such as the point release, rating and description. Most importantly of course, you can install it by simply clicking “Install Now”.

Installazione manuale

The manual installation method involves downloading our plugin and uploading it to your webserver via your favorite FTP application. The
WordPress codex contains instructions on how to do this here.


Gli aggiornamenti automatici dovrebbero funzionare perfettamente; come sempre però, assicurati di avere un backup per sicurezza.

Nell’improbabile caso che dopo un aggiornamento tu abbia problemi con le pagine negozio/categoria devi semplicemente rigenerare i permalink andando in WordPress > Impostazioni > Permalink e premere ‘salva’. Questo dovrebbe fare tornare tutto alla normalità.


Questo plugin funziona con le carte di credito o solo con PayPal?

This plugin supports payments using both credit and debit cards as well as PayPal. The new Smart Payment Buttons feature dynamically displays PayPal, Venmo (US Only), PayPal Credit, or other local payment options* in a single stack—without needing to leave the merchant’s website.

*PayPal Checkout features may not be available in all countries.

Supporta Checkout con PayPal dalla visualizzazione del carrello?


Supporta sia la modalità produzione sia la modalità sandbox per i test?

Sì lo fa – la modalità produzione o sandbox dipende dal tipo di connessione. Puoi scegliere di connettere in uno dei due modi, e disconnettere e riconnetere nell’altro modo quando vuoi.

Dove trovo la documentazione?

Per un aiuto nell’installazione e nella configurazione, fai riferimento alla nostra guida utente

Dove posso ricevere supporto o parlare con altri utenti?

Se hai un problema, puoi chiedere aiuto nel forum del plugin.

Questo plugin funzionerà col mio tema?

Sì, questo plugin funzionerà con ogni tema, ma potrebbe richiedere qualche modifica stilistica. Se stai cercando un tema integrato nativamente con WooCommerce ti consigliamo Storefront.

Dove posso richiedere nuove funzionalità o segnalare bug?

Nuove richieste di funzionalità e segnalazioni di bug possono essere effettuate nel forum del plugin.

Come si rimuove il pulsante ‘Concludi Ordine’ dalla pagina del carrello?

If PayPal Checkout is the only enabled payment gateway and you want to remove the ‘Proceed to Checkout’ button from the cart, you can use this snippet:

<?php // Do not include this if already open!
* Code goes in theme functions.php.
remove_action( 'woocommerce_proceed_to_checkout', 'woocommerce_button_proceed_to_checkout', 20 );

view raw
hosted with ❤ by GitHub

Come posso contribuire?

Il repository GitHub di PayPal Checkout è qui:


Please use this to inform us about bugs, or make contributions via PRs.


30 Agosto 2020
As I have inspected, issues are mainly with - 1. Session and nonce verification issue for other plugins. Other simple plugins are not working correctly with this plugin. Too poor performance.
5 Agosto 2020
I'm amazed at how many bad reviews this plugin has, then I installed it and can see why. This has so much potential but has so many issues it seems. Terminology is wrong in places, so instructions are wrong. The Credit/Debit card entry can take 2-3 seconds to appear, no feedback for the end user when they press a button and realise they need to scroll down for a new section which has appeared, so UX is terrible. It deserves 5 stars as you can get it all to work, and this is a free plugin, but I've left 3 stars for it's sloppy coding and assume it's been developed by too many people or change of coders since it's been created.


11 Luglio 2020
What happened in this plugin ? suddenly the payment button vanished from the forms 🙁 i pref this because of its professional design but its not working now 🙁
11 Giugno 2020
Wow, without warning this plugin dropped the ball. Many customers suddenly couldn't check out using credit card anymore. That narrow billing form that suddenly requires customers to enter their billing details a 2nd time after just having completed the main checkout form is not good usability. The delay until that form appears without any indicator about what's happening is not great. Backend functionality that doesn't work as intended (hiding payment methods) All in all sadly not good enough, so have disabled it again. 2 stars only because it seems support here is working and the team seem to be aware of the issues.
Leggi tutte le recensioni di 85

Contributi e sviluppo

“WooCommerce PayPal Checkout Payment Gateway” è stato tradotto in 11 lingue. Grazie ai traduttori per i loro contributi.

Traduci “WooCommerce PayPal Checkout Payment Gateway” nella tua lingua.

Ti interessa lo sviluppo?

Esplora il Codice segui il Repository SVN iscriviti al Log delle Modifiche. Puoi farlo tramite RSS con un lettore di feed.

Changelog (registro delle modifiche)

2.1.1 – 2020-11-24

  • Fix – Update the bundle.pem file to use the certificates from PayPal. PR#822
  • Tweak – PHP 8.0 compatibility. PR#837

2.1.0 – 2020-10-06

  • New – Add support for PayPal Credit messaging. PR#810
  • Fix – Hide the “Pay Later” funding method when “PayPal Credit” is disabled. PR#811
  • Fix – Display correct image size in the PayPal Checkout window. PR#779

2.0.3 – 2020-07-01

  • Fix – Records the proper refunded_amount to _woo_pp_txnData in the database PR#764
  • Fix – Redirect customers back to the original page they left on after closing PayPal modal PR#765
  • Fix – Preserve horizontal layout style setting when using standalone buttons PR#774
  • Fix – Smart payment buttons compatibility with older browsers PR#778
  • Tweak – Update the Require Phone Number field description PR#772
  • Dev – Make the SDK script args filterable PR#763

2.0.2 – 2020-05-28

  • Fix – Javascript errors during checkout when the Payment Action is set to Authorize. PR#754
  • Fix – Style the Smart Payment Buttons according to the chosen button size setting. PR#753
  • Tweak – Change the “or” separator used on the cart page to be consistent with other payment gateways (uppercase and 100% opacity). PR#755

2.0.1 – 2020-05-26

  • Fix – PayPal buttons not loading on the page, accompanied with the javascript/console error: “paypal.getFundingSources (or paypal.Buttons) is not a function”. PR#740

2.0.0 – 2020-05-25

  • New – Upgrade to the latest PayPal Checkout Javascript SDK. PR#668
  • Add – New setting found under Button Styles for choosing a Smart Payment Button label. PR#666
  • Add – Support for more locales. PR#658
  • Fix – Display Smart Payment Buttons on Product pages built from a shortcode. PR#665
  • Fix – Send the product SKU to PayPal so it’s displayed in the order/transaction details and reports on PayPal. PR#664
  • Fix – Show an error when saving incomplete/missing API credentials. PR#712
  • Fix – Remove PHP warnings in later versions of PHP when a PayPal Session doesn’t exist. PR#727
  • Fix – Error when processing refunds (Already Refunded. No Amount to Refund). PR#710
  • Fix – Required state field errors on the “Confirm your PayPal Order” page when returning from PayPal. PR#725
  • Fix – Display WC Add To Cart validation errors on the product page when clicking the PayPal Smart Payment Buttons. PR#707
  • Update – Smart Payment Buttons are enabled by default and settings to toggle these on/off have been removed and replaced with a filter. PR#660
  • Update – Deprecate unused/incomplete function WC_Gateway_PPEC_Client::update_billing_agreement(). PR#602
  • Update – Move inline javascript found in settings-ppec.php to ppec-settings.js. PR#676
  • Update – Move Support and Documentation links from the plugin actions to plugin meta section on the Plugin activation/deactivation page. PR#735
  • Update – WooCommerce 4.1 and WordPress 5.4 compatibility. PR#732

1.6.21 – 2020-04-14

  • Fix – Ensure Puerto Rico and supported Locales are eligible for PayPal Credit. PR#693
  • Fix – Support purchasing subscriptions with $0 initial payment – free trials, synced etc. PR#698
  • Fix – Only make the billing fields optional during an active PayPal Checkout session. PR#697
  • Fix – Uncaught JS errors on product page when viewing and out-of-stock product. PR#704
  • Fix – Loading API certificates and improves managing certificate settings. PR#696
  • Fix – Displaying PayPal Smart Payment buttons on pages with single product shortcode. PR#665
  • Fix – Do not add discounts to total item amount and cause line item amount offset. PR#677
  • Fix – Redirect to Confirm your PayPal Order page for subscriptions initial purchases using PayPal Smart Buttons. PR#702
  • Fix – Display missing checkout notice when email format is incorrect. PR#708
  • Add – Filter product form validity via a new wc_ppec_validate_product_form event. PR#695
  • Add – Translation tables for states of more countries. PR#659
  • Update – WooCommerce 4.0 compatibility

1.6.20 – 2020-02-18

  • Fix – Upgrade the plugin on plugins loaded rather than on plugin init. PR#682

1.6.19 – 2020-02-06

  • Fix – Check if order exists before adding order actions. PR #653
  • Fix – Global attributes stripped before sent to PayPal if unicode characters. PR#470
  • Fix – Handle subscription payment change. PR#640
  • Fix – Fixes error “Trying to get property of non-object” found during onboarding wizard. PR#654
  • Fix – Hide smart payment buttons on mini cart when cart is empty. PR#450
  • Fix – Only display smart buttons on product page if product is in stock. PR#662
  • Fix – Do not display smart buttons for external products and grouped products. PR#663
  • Update – Display a WooCommerce pre 3.0 admin notice warning. In an upcoming release PayPal Checkout will drop support for WC 2.6 and below. PR#671

1.6.18 – 2019-12-05

  • Fix – Send fees to PayPal as line items
  • Fix – Fix error 10426 when coupons are used
  • Fix – Call to a member function has_session() on null
  • Add – Notice about legacy payment buttons deprecation
  • Fix – Use order currency when renewing subscription instead of store currency
  • Update – WooCommerce 3.8 compatibility
  • Update – WordPress 5.3 compatibility

1.6.17 – 2019-08-08

  • Update – WooCommerce 3.7 compatibility
  • Add – Filter to require display of billing agreement during checkout
  • Add – Add CURRENCYCODE to capture_payment
  • Add – Add filter for buttons on products
  • Fix – Skip wasteful render on initial Checkout page load
  • Fix – Appearance tweaks on Checkout screen

1.6.16 – 2019-07-18

  • Fix – Don’t require address for renewal of virtual subscriptions
  • Fix – Avoid broken confirmation screen edge case after 10486 redirect

1.6.15 – 2019-06-19

  • Fix – Prevent PHP errors when no billing details are present in PP response
  • Fix – Require billing address for virtual products when enabled
  • Add – Hook when a payment error occurs

1.6.14 – 2019-05-08

  • Fix – Failing checkout when no addons are used

1.6.12 – 2019-05-08

  • Fix – Better handling of virtual subscriptions when billing address is not required
  • Fix – Prevent errors showing when purchasing a virtual product with WP_DEBUG enabled

1.6.11 – 2019-04-17

  • Fix/Performance – Prevent db option updates during bootstrap on each page load
  • Tweak = WC 3.6 compatibiliy.

1.6.10 – 2019-03-05

  • Fix – Use only product attributes when adding to cart

1.6.9 – 2019-02-03

  • Fix – Avoid SPB render error by tweaking ‘allowed’ funding methods’ empty value

1.6.8 – 2019-01-25

  • Fix – Guard against themes applying filter with too few params

1.6.7 – 2019-01-25

  • Fix – Error 10413 when using coupons
  • Fix: All variation details when using buttons on product pages are kept
  • Fix: Always render the PayPal buttons in the mini cart

1.6.6 – 2019-01-09

  • Fix – Discount items were not being included
  • Add – Filter for order details to accept decimal quantities of products
  • Fix – Unable to buy variation from product page
  • Fix – Can use PayPal from product page without inputting required fields
  • Add – Display PayPal fees under the totals on the order admin page
  • Add – Prefill name, phone, and email info in PayPal Guest Checkout from checkout screen

1.6.5 – 2018-10-31

  • Fix – Truncate the line item descriptions to avoid exceeding PayPal character limits.
  • Update – WC 3.5 compatibility.
  • Fix – checkout.js script loading when not needed.
  • Fix – Missing shipping total and address when starting from checkout page.

1.6.4 – 2018-09-27

  • Fix – Billing address from Checkout form not being passed to PayPal via Smart Payment Button.
  • Fix – Checkout form not being validated until after Smart Payment Button payment flow.

1.6.3 – 2018-08-15

  • Fix – Fatal error caused by a fix for Smart Payment Buttons.

1.6.2 – 2018-08-15

  • Fix – Tax not applied on the (Confirm your PayPal order) page at the checkout.

1.6.1 – 2018-07-04

  • Fix – GDPR Fatal error exporting user data when they have PPEC subscriptions.
  • Fix – PayPal Credit still being disabled by default.
  • Update – Rename ‘PayPal Express Checkout’ to ‘PayPal Checkout’.
  • Fix – Missing PayPal branding in “Buy Now” Smart Payment Button.
  • Fix – PHP warning when PayPal Credit not supported and no funding methods hidden.
  • Fix – Smart Payment Buttons gateway not inheriting IPN and subscription handling.
  • Fix – Single product Smart Payment Button failing without existing session.
  • Fix – When cart is empty, JS error on cart page and mini-cart payment buttons showing.
  • Add – Locale filter.

1.6.0 – 2018-06-27

  • Add – Smart Payment Buttons mode as alternative to directly embedded image links for all instances of PayPal button.
  • Fix – Help tip alignment for image settings.
  • Update – Enable PayPal Credit by default, and restrict its support by currency.
  • Update – Omit ‘Express Checkout’ portion of default payment method title.
  • Update – Enable Express Checkout on regular checkout page by default.
  • Update – Enable Express Checkout on single product page by default.

1.5.6 – 2018-06-06

  • Fix – Virtual products cause issues with billing details validation.

1.5.5 – 2018-05-23

  • Update – WC 3.4 compatibility
  • Update – Privacy policy notification.
  • Update – Export/erasure hooks added.

1.5.4 – 2018-05-08

  • Add – Hook to make billing address not required woocommerce_paypal_express_checkout_address_not_required (bool).
  • Fix – Duplicate checkout settings when PP Credit option is enabled.
  • Fix – Impossible to open API credentials after saving Settings.
  • Fix – Prevent filtering if PPEC is not enabled.
  • Fix – Single Product checkout: Quantity being duplicated due to multiple AJAX calls.
  • Fix – When returning from PayPal, place order buttons says “proceed to payment”.
  • Tweak – Default billing address to be required.

1.5.3 – 2018-03-28

  • Fix – wp_enqueue_media was not correctly loaded causing weird behavior with other parts of system wanting to use it.
  • Fix – Typo in activation hook.

1.5.2 – 2018-02-20

  • Tweak – Express checkout shouldn’t display “Review your order before the payment”.
  • Fix – Compatibility with Subscriptions and Checkout from Single Product page.
  • Fix – Make sure session object exists before use to prevent fatal error.

See changelog for all versions.