WooCommerce PayPal Checkout Payment Gateway

Beskriuwing

⚠️ Support for PayPal Checkout will discontinue from 1 Mar 2022 and updates to the plugin have stopped as of 1 Sept 2021. We recommend switching to PayPal Payments.

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.

Also, with Integrated PayPal Setup (Easy Setup), connecting to PayPal is as simple as clicking a button – no complicated API keys to cut and paste.

Skermôfbyldings

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 with PayPal directly from the Cart.
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.

Ynstallaasje

Minimum Requirements

WordPress 4.4 or greater

Automatic installation

Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser. To do an automatic install of, log in to your WordPress dashboard, navigate to the Plugins menu and click Add New.

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”.

Manual installation

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.

Updating

Automatic updates should work like a charm; as always though, ensure you backup your site just in case.

If on the off-chance you do encounter issues with the shop/category pages after an update you simply need to flush the permalinks by going to WordPress > Settings > Permalinks and hitting ‘save’. That should return things to normal.

FAQ

Does this plugin work with credit cards or just 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.

Does this support Checkout with PayPal from the cart view?

Yes!

Does this support both production mode and sandbox mode for testing?

Yes it does – production and sandbox mode is driven by how you connect. You may choose to connect in either mode, and disconnect and reconnect in the other mode whenever you want.

Where can I find documentation?

For help setting up and configuring, please refer to our user guide

Where can I get support or talk to other users?

If you get stuck, you can ask for help in the Plugin Forum.

Will this plugin work with my theme?

Yes, this plugin will work with any theme, but may require some styling to make it match nicely. If you’re
looking for a theme with built in WooCommerce integration we recommend Storefront.

Where can I request new features or report bugs?

New feature requests and bugs reports can be made in the plugin forum.

How to remove ‘Proceed to Checkout’ button from cart page?

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

functions.php

hosted with ❤ by GitHub

Where can I contribute?

The GitHub repository for PayPal Checkout is here:

https://github.com/woocommerce/woocommerce-gateway-paypal-express-checkout

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

Resinsjes

nejcox 29 augustus, 2022 1 reakce

Works but button doesn't show in quick cart (sidebar).

meatface888 26 july, 2022 9 antwurden

If any required data fields are not filled in or terms and condition is not checked off Paypal still launches a window and shows loading screen indefinitely. No error or prompt that tells customer they are missing these. Not long ago it would go through the process and ask you to login and then error it trys to process payment. It's been broken like this for many months. I would give this plugin a negative if I could as I have lost customers and have had customers complain my site is broken. It's really bad this is the only plugin available if you want to use Paypal payments.

soulrider71 25 april, 2022 3 antwurden

Why do you stop the support for a plugin that works and replace it with a plugin that doesn´t work (for a unacceptable share of installations)?

smolgiant 25 febrewaris, 2022 1 reakce

Refund option only leave manually refunds...

webgecko 29 desimber, 2021 1 reakce

This AddOn doesn't work, it's crab! Hands off!

Miso 25 novimber, 2021 1 reakce

Didn't work well on my test web site and very glad I tested first before screwing up my live site. Does not respect the ordering of payment method buttons according to the priority of payment methods configured in Woocommerce settings. Instead, it forces its way to the top, which a complete deal breaker because I also have Stripe (lower fees) and Klarna. Furthermore, it seems you end up on a monthly billing plan when you make the switch, and it's not reversible!

Lês alle 103 resinsjes

Meiwurkers & amp; Untwikkelders

"WooCommerce PayPal Checkout Payment Gateway" is iepen boarne software. De folgjende minsken hawwe bydroegen oan dizze plugin.

"WooCommerce PayPal Checkout Payment Gateway" is oerset yn 12 lokaasjes. Tank oan de oersetters foar harren bydragen.

Oersette "WooCommerce PayPal Checkout Payment Gateway" yn jo taal.

Ynteressearre yn ûntwikkeling?

Blêdzje troch de koade , besjoch de SVN-repository , of abonnearje op it ûntwikkelingslogboek troch RSS .

Feroaringslog

2.1.3 – 2021-09-16

Tweak – Remove broken URL from plugin headers. PR#887
Tweak – Update notice on plugins page about support and EOL. PR#886

2.1.2 – 2021-06-28

Fix – Prevent fatal error when a line item isn’t a WC_Product instance. PR#872
Fix – [WC Subscriptions] Update the shipping packages address using a dynamic key rather than assuming a 0 index. PR#871
New – Allow hiding of funding methods MercadoPago and BLIK. PR#870
Tweak – Make labels/descriptions more consistent on the settings screen. PR#771
Tweak – Make WooCommerce 3.2.0 explicit. PR#868
Dev – Add hooks to alter names and descriptions of line items sent to PayPal. PR#869
Fix – Create session cookie only when needed. PR#793, PR#845.
Tweak – Mark as compatible with latest WordPress and WooCommerce. PR#867
Fix – Replace jQuery 3.x deprecated functions. PR#852
Fix – Honor shape settings when rendering buttons for alternative funding sources. PR#844
New – Add notice on plugins page to upgrade to PayPal Payments. PR#866

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.