PayPal Checkout

WooCommerce PayPal Checkout allows your store to accept payments via PayPal and uses customizable Smart Payment Buttons.

Installation ↑ Back to top

  1. Go to: Plugins > Add New on your WordPress site.
  2. Enter WooCommerce PayPal Checkout in the Search Plugins bar. Author is Automattic/WooCommerce.
  3. Install Now and Activate.

More information at: Install and Activate Plugins/Extensions.

Requirements ↑ Back to top

Setup and Configuration ↑ Back to top

To set up PayPal Checkout:

  1. Go to: WooCommerce > Settings > Payments.
    Note: ‘Payments’ formerly called ‘Checkout’ prior to WooCommerce 3.4.
  2. Use the toggle under Enabled to select PayPal Checkout.
  3. Select Set Up. Or click PayPal Checkout. You are taken to PayPal Checkout settings.
  4. Configure your settings:
    • Enable/Disable – Enable to use. Disable to turn off.
    • Title – Choose the title shown to customers during checkout
    • Description – Add info shown to customers if they use PayPal Checkout.
    • Account Settings – Environment  – Live to accept payments. Sandbox to test payments.

API Settings ↑ Back to top

Connect a new or existing PayPal account.

  1. Select Setup or link an existing PayPal Account to add your API Credentials by logging into your PayPal account.
    (Should you use Click here to toggle manual API credential input, a new meta box opens.)
  2. Log into your PayPal account when prompted.
  3. Select My Selling Tools on the left side of the page to display all tools, then scroll down to API Access and click Update to view credentials.
  4. Copy and paste the relevant credentials into the fields on your WooCommerce site:
    • Live API Username
    • Live API Password
  5. API Certificate and Signature, and Live API Subject are optional.

PayPal-hosted Checkout Settings ↑ Back to top

Note: Formerly called Display Settings in PayPal Express Checkout, prior to version 1.6.

  1. Enter a Brand Name that displays during checkout on the PayPal site, e.g., Name of your business/store/site.
  2. Enter the https:// URL of an existing icon/photo you wish to display as the Logo Image and Header Image during checkout (optional). Add a logo/icon or photo at: Add Image > Upload Files. Or use an existing one at: Add Image > Media Library.
  3. Select a Page Style (optional). Page styles are shown on your PayPal account.
  4. Select a Landing Page, which all customers initially see on checkout.

Advanced Settings ↑ Back to top

  1. Tick the box to Enable Logging when troubleshooting issues with your site. Otherwise, leave unticked/disabled.
  2. Enter an Invoice Prefix to identify which are online orders. WC (WooCommerce) is entered by default.
  3. Tick the box to Require Billing Address during checkout. *Note: This feature is no longer supported by PayPal. If you need to collect billing address, you could turn off the payment buttons on the product and cart pages, and collect that information using the normal WooCommerce checkout fields.
  4. Tick the box to Require Phone Number.
  5. Select Payment Action from the drop-down. Sale captures funds immediately. Authorize only verifies availability of fund; you must later capture funds.
  6. Tick the box if you Require Instant Payment. Customer must use a payment method allowing immediate capture (e.g., No checks).
  7. Select preference for Subtotal Mismatch Behavior if totals for PayPal and WooCommerce are different, so transaction can complete.

Button Settings ↑ Back to top

  1. Select Use Smart Payment Buttons if you wish to customize and display them during checkout and mobile (recommended). Other buttons will be deprecated in future versions.
  2. Select a Button Size from the dropdown.
  3. Tick the box to Enable PayPal Credit (*), if you wish to to offer financing to customers.
  4. Tick the box for Enable PayPal Checkout on cart page, if you wish to display.
  5. Tick the box for Checkout on Single Product, if you wish to allow customers to speed to checkout while on an Individual product page.
  6. Tick the checkbox to Enable PayPal Mark if you would like to display the PayPal name during checkout on your site, which can give customers assurance.
  7. Save changes.

*PayPal Credit is available in the United States (US); PayPal Credit is available in the United Kingdom (UK) by invite only.

How to obtain PayPal credentials ↑ Back to top

This applies if you choose to manually enter PayPal credentials in step 4 above. You need a PayPal Business account.

1/ Log into your PayPal Business account at:

2/ Click the profile icon in the top right, then Profile & Settings.

WooCommerce paypal express View PayPal Profile

3/ Select My Selling Tools on the left side of the page to display all tools, then scroll down to API Access and click Update to view credentials.

WooCommerce paypal express view api credentials

4/ Select Option 2 to Request API signature.

Request API credentials

5/ Use API signature, not API certificate credentials.

WooCommerce PayPal Express Payment Gateway API credentials

6/ Copy your API Username, Password and Signature to paste into your WooCommerce PayPal Checkout settings.

WooCommerce PayPal Express Payment Gateway API Credentials

Venmo Setup ↑ Back to top

With Use Smart Payment Buttons enabled your customers will have the option to pay with Venmo. This does take some setup on their side in the Venmo app. If a customer wants to pay with Venmo, or you’d like to test this yourself, follow along.

  • First, open up the Venmo app and head into the settings.
  • Next select Connect Browsers and tap to connect any browsers you’d like to use.
  • Visit your site to see Venmo now available to tap and pay with!

Processing Orders ↑ Back to top

Usage with PayPal accounts and credit/debit cards 

This extension skips most of the WooCommerce checkout process, and customers leave your site from the Cart page to complete checkout through PayPal.

PayPal Checkout is meant to reduce the amount of data entry (and possible error) required by the customer. To achieve this, PayPal Checkout sends the customer’s billing information after they log into PayPal and authorize the transaction.

Typical scenario:

  • Customer shops on your site
  • Customer adds products to Cart
  • Customer reviews Cart page
  • From the Cart page customer selects “Checkout with PayPal” button
  • Customer is redirected to PayPal, and WooCommerce sends the subtotal of the order, customer info, and shipping address to PayPal (Customers can still enter a new shipping address).
  • Customer logs into PayPal and authorizes transaction*
  • PayPal redirects customer back to WooCommerce and sends authorization token and customer billing information
  • On WooCommerce Review Order page, customer views any taxes and chooses a shipping option
  • Customer finalizes order, and the transaction is completed with PayPal using order Grand Total

*Order authorization is obtained for an amount that is 150% of the subtotal to anticipate taxes and shipping costs. If there are no taxes or shipping costs, then the original amount is used. If there are shipping/taxes, the updated total is used.

Usage with PayPal Credit

Customers see the option to use PayPal Credit in checkout, if the checkbox for Enable PayPal Credit is ticked in Display Settings from Setup and Configuration.

The store/site owner is paid in full up front. Customers enjoy financing and are given time to pay.

Admin Usage ↑ Back to top

Capture Charges from WooCommerce Order Admin

This extension allows you to authorize charges during checkout, then manually capture funds later. You can do this via your PayPal business account, or from the WooCommerce Edit Order page. Not sure what this means? Check out this tutorial on Authorizing vs. Authorizing and Capturing.

When payment is authorized for an order, the order status is set to “on hold.” You can edit the order by going to WooCommerce > Orders, then clicking the order number to edit the order that needs to have the charge captured. PayPal adds the new “Capture Charge” action to the Order Actions menu:

WooCommerce PayPal Express Capture Charge
PayPal Checkout Capture Charge

Once you select Capture Charge and save the order, payments are captured via PayPal, the order status updates to Processing, and the Order notes update to reflect these changes.

Customization ↑ Back to top

Note: This is a Developer level section. If you are unfamiliar with code/templates and resolving potential conflicts, select a WooExpert or Developer for assistance. We are unable to provide support for customizations under our  Support Policy.

Make Billing Address not Required ↑ Back to top

Use the hook:


Remove the “Proceed to Checkout” link on the cart page ↑ Back to top

Note: This is a Developer level section. If you are unfamiliar with code and resolving potential conflicts, select a WooExpert or Developer for assistance. We are unable to provide support for customizations under our  Support Policy.

Troubleshooting ↑ Back to top

You can turn on logging for this plugin via the plugin settings:

Enable logging

Logs will be available via WooCommerce > System Status > Logs.

Frequently Asked Questions ↑ Back to top

Does PayPal Checkout include support for Subscriptions? ↑ Back to top

Yes, PayPal Checkout supports recurring payments when used with WooCommerce Subscriptions (separate purchase).

You must apply for and enable Reference Transactions via Express Checkout with PayPal for this plugin to work with subscriptions. More information at: PayPal Reference Transactions for Subscriptions.

Why do I get errors when I test PayPal Checkout in Sandbox Mode? ↑ Back to top

You cannot have the “PayPal Sandbox” option turned on and use production API credentials. Go to and create a Buyer and a Seller profile to create a sandbox account.

You can request sandbox credentials in the same way you request live credentials once your account is set up. Put the seller’s API credentials into the WooCommerce admin for PayPal Checkout and use the buyer’s credentials to test purchases with.

When you want to return to production mode, change back to production/live API credentials.

Is there an extra fee to offer PayPal Credit to customers? ↑ Back to top

There’s no extra charge for this service to the store/site owner.

If you are a PayPal accepting merchant, PayPal Credit is already included at checkout at no additional cost to your business. You just pay your current PayPal transaction fees.

Is PayPal Credit available in all countries? ↑ Back to top

It is available without limitation in the United States (US). It is available by invite only in the United Kingdom (UK).

Do I need to accept PayPal to offer PayPal Credit? ↑ Back to top

Yes. You must have an eligible PayPal payment solution integrated with your website to offer PayPal Credit (either through the PayPal checkout or as a PayPal Credit checkout button) and to advertise financing on your website.

When do I get paid if my customers pay using PayPal Credit? ↑ Back to top

You get paid up front, even though your customers have more time to pay. Payments usually show in your PayPal account within minutes, similar to any other PayPal transaction.

Questions ↑ Back to top

Have a question or need some assistance? Get in touch with a Happiness Engineer via the Help Desk.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top