WooCommerce PayPal Checkout allows your store to accept payments via PayPal and uses customizable Smart Payment Buttons™, enabling customers to pay without leaving your site
Installation ↑ Back to top
- Go to: Plugins > Add New on your WordPress site.
- Enter WooCommerce PayPal Checkout in the Search Plugins bar. Author is Automattic/WooCommerce.
- Install Now and Activate.
More information at: Install and Activate Plugins/Extensions.
Requirements ↑ Back to top
- A PayPal Business account – go to PayPal.com to sign up or log in to your existing account
- PayPal Reference Transactions via Express Checkout for Subscriptions – apply for and enable Reference Transactions if you intend to use and sell WooCommerce Subscriptions
Setup and Configuration ↑ Back to top
To set up PayPal Checkout:
- Go to: WooCommerce > Settings > Payments.
Note: ‘Payments’ formerly called ‘Checkout’ prior to WooCommerce 3.4.
- Use the toggle under Enabled to select PayPal Checkout.
- Select Set Up. Or click PayPal Checkout. You are taken to PayPal Checkout settings.
- 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.
- 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.)
- Log into your PayPal account when prompted.
- 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.
- Copy and paste the relevant credentials into the fields on your WooCommerce site:
- Live API Username
- Live API Password
- 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.
- Enter a Brand Name that displays during checkout on the PayPal site, e.g., Name of your business/store/site.
- 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.
- Select a Page Style (optional). Page styles are shown on your PayPal account.
- Select a Landing Page, which all customers initially see on checkout.
Advanced Settings ↑ Back to top
- Tick the box to Enable Logging when troubleshooting issues with your site. Otherwise, leave unticked/disabled.
- Enter an Invoice Prefix to identify which are online orders. WC (WooCommerce) is entered by default.
- Tick the box to Require Billing Address during checkout. *Note: This feature must be enabled on your Merchant/Business account after contacting PayPal. Otherwise, a notice appears that: “Require Billing Address has not been enabled by your account and has been disabled.”
- Tick the box to Require Phone Number.
- Select Payment Action from the drop-down. Sale captures funds immediately. Authorize only verifies availability of fund; you must later capture funds.
- Tick the box if you Require Instant Payment. Customer must use a payment method allowing immediate capture (e.g., No checks).
- Select preference for Subtotal Mismatch Behavior if totals for PayPal and WooCommerce are different, so transaction can complete.
Button Settings ↑ Back to top
- 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.
- Select a Button Size from the dropdown.
- Tick the box to Enable PayPal Credit (U.S. only), if you wish to to offer financing to customers.
- Tick the box for Enable PayPal Checkout on cart page, if you wish to display.
- Tick the box for Checkout on Single Product, if you wish to allow customers to speed to checkout while on an Individual product page.
- 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.
- Save changes.
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: https://www.paypal.com/us/webapps/mpp/merchant.
2/ Click the profile icon in the top right, then Profile & Settings.
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/ Select Option 2 to Request API signature.
5/ Use API signature, not API certificate credentials.
6/ Copy your API Username, Password and Signature to paste into your WooCommerce PayPal Checkout settings.
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.
- 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:
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
Make Billing Address not Required ↑ Back to top
Use the hook:
Remove the “Proceed to Checkout” link on the cart page ↑ Back to top
Troubleshooting ↑ Back to top
You can turn on logging for this plugin via the plugin settings:
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). Two things are required for recurring payments to work properly with PayPal Checkout:
- You must apply for and enable Reference Transactions via Express Checkout with PayPal for this functionality to work with subscriptions. More information at: PayPal Reference Transactions for Subscriptions.
- A billing address must be associated with the subscription. Ensure that the Require Billing Address box is ticked as explained in Advanced Settings.
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 https://developer.paypal.com/ 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’s only available in the United States at the moment.
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.