Installation ↑ Back to top
- Go to: Plugins > Add New on your WordPress site.
- Enter WooCommerce PayPal Express Checkout in the Search Plugins bar. Author is Automattic/WooCommerce.
- Install Now and activate.
More information at: Install and Activate Plugins/Extensions.
Setup and Configuration ↑ Back to top
To set up PayPal Express Checkout:
- Go to: WooCommerce > Settings > Checkout> PayPal Express Checkout.
- Tick the checkbox to Enable PayPal Express Checkout to offer this gateway as an option. Untick to disable.
- Add your API Credentials by clicking the Setup or Link an Existing PayPal Account button. Connects your PayPal account with this gateway or gives the option for signup.
API Settings ↑ Back to top
Should you select Click Here to Toggle Manual API Credential Input, a new meta box is toggled open.
- Log into your PayPal account.
- 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.
Display Settings ↑ Back to top
- Enter a Brand Name that displays during checkout on the PayPal site, e.g., Name of your business/store/site.
- Select a Button Size from the drop-down.
- 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.
- 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: Media > Add New.
- Select a Page Style (optional). Page styles are shown on your PayPal account.
- Select a Landing Page, which all customers initially see on checkout.
- Tick the checkbox to Enable PayPal Credit (U.S. only), if you wish to to offer financing to customers.
Advanced Settings ↑ Back to top
- Tick the checkbox 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 checkbox 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.”
- Select Payment Action from the drop-down. Sale captures funds immediately. Authorize only verifies availability of fund; you must later capture funds.
- Tick the checkbox for Instant Payment. Customer must use a payment method allowing immediate capture (e.g., No checks).
- Select preference for Subtotal Mismatch Behavior if there’s totals for PayPal and WooCommerce are different, so transaction can complete.
- 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 Express settings.
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 Express is meant to reduce the amount of data entry (and possible error) required by the customer. To achieve this, PayPal Express 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
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.
FAQ ↑ Back to top
Does PayPal Express Checkout include support for Subscriptions? ↑ Back to top
Yes, PayPal Express Checkout supports recurring payments when used with WooCommerce Subscriptions (separate purchase).
Why do I get errors when I test PayPal Express 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 Express 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.