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.

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.


  • 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.
  • 下記の PayPal ボタンの設定を参照してください。
  • Checkout with PayPal directly from the Cart.
  • そして店を出ることなく。
  • 「続ける」をクリックして詳細を確認してください。
  • 通常のチェックアウトページから PayPal を選択してください。
  • 単一の商品ページから PayPal を選択します。
  • ミニカートからチェックアウトを開始します。



  • WordPress 4.4 or greater


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


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.



更新後にショップ/カテゴリページで問題が発生する場合は、WordPress に移動してパーマリンクをフラッシュするだけで済みます> 設定> パーマリンクと「保存」を押す。 それは物事を正常に戻すはずです。


このプラグインはクレジットカードまたは PayPal のみで動作しますか?

このプラグインは、PayPal と同様にクレジットカードとデビットカードの両方を使用した支払いをサポートします。 新しいスマートペイメントボタン機能は、PayPal、Venmo(米国のみ)、PayPal クレジット、またはその他の現地支払いオプション*を1つのスタックに動的に表示します。マーチャントのサイトを離れる必要はありません。

*PayPal Checkout 機能はすべての国で利用できるわけではありません。

これは、カートビューからの PayPal による Checkout をサポートしていますか?



はい、できます – 本番モードとサンドボックスモードは接続方法によって決まります。 どちらかのモードで接続し、いつでも他のモードで切断および再接続することができます。






はい、このプラグインはどのテーマでも動作しますが、うまく調和させるためにスタイルを設定する必要があります。 もしあなたが〜なら
WooCommerce 統合が組み込まれたテーマを探している場合は、Storefrontをお勧めします。




PayPal Checkout が唯一の有効な支払いゲートウェイであり、カートから「お支払いへ進む」ボタンを削除する場合、次のスニペットを使用できます。

<?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


PayPal Checkout 用の GitHub リポジトリはこちらです。


これを使ってのバグについて私たちに知らせたり、PRs を通じて貢献してください。


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


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


“WooCommerce PayPal Checkout Payment Gateway” は11ロケールに翻訳されています。 翻訳者のみなさん、翻訳へのご協力ありがとうございます。

“WooCommerce PayPal Checkout Payment Gateway” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログRSS で購読してみてください。


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.