Target Audience

Please make sure you have installed the PayPal for WooCommerce plugin to prepare for this step.


PayPal Complete Payments is a full-stack solution that provides a wide variety of features and functionality for sellers.

Allow customers to pay via Credit or Debit Card, PayPal Checkout, Pay Later and Venmo, as well as a variety of alternative payment methods based on the country you are located in.

All of this and more tied into a single PayPal payments integration.  Just follow the steps below to be up-and-running in no time!

1. Go to the PayPal Complete Payments Welcome Screen

From the WordPress admin dashboard, go to Settings -> PayPal Complete Payments.

PayPal Complete Payments Settings Menu

2. Begin the Onboarding Process

Depending on whether you are a new user or an existing user upgrading to PayPal Complete Payments you will see one screen or another.

New Users

Click the Start Now button to begin the process of connecting your PayPal account to the plugin.

PayPal Commerce Platform for WooCommerce Onboarding Screen

Upgrading from PayPal Classic?

Click the “Update to PayPal Complete Payments” button to begin the upgrade procedures.

If you are running WooCommerce subscriptions, any active profiles you have linked to PayPal Classic Express Checkout and/or PayPal Pro will be updated to use the new PayPal Commerce gateway.

Upgrade PayPal Classic to PayPal Commerce Platform

3. Connect PayPal Account

PayPal Onboarding Email
Notes to Consider

Account Connection / Creation

  • If you already have a PayPal account it will then ask you to login to the existing account.
  • If the email you entered is not linked to a PayPal account, then it will walk you through the steps to create the new account.

Sandbox Testing

  • If you are trying to configure the plugin for testing purposes with the PayPal Sandbox, you will first need go to WooCommerce -> Settings -> Payments -> Complete Payments – Built by Angelleye.
  • From there you can enable Sandbox Mode, and then click to return to these Setup screens from there.
PayPal Complete Payments Onboarding Login
PayPal Onboarding Agree and Connect
PayPal Complete Payments Onboarding Go Back

NOTE: Depending on your account type and settings you may be asked to verify some of your identity and business details during this onboarding flow.  Just fill out the info accordingly and continue through the screens until you get to the screen that says “Go back to…” so you can click that button.

4. PayPal Account Connection Complete!

WooCommerce Payments - PayPal Onboarding Completed

Congrats!  At this stage you now have PayPal Complete Payments fully connected and ready to accept payments on your site!

There are many options available in our plugin so that you can fine-tune where buttons are displayed, how they look, and more.

Click the Modify Setup button to load the page with these options.

5. Modify PayPal Complete Payments Options

There are two ways to get into the PayPal Complete Payments settings panel from the WordPress admin panel.

WordPress Settings

Go to Settings -> PayPal Complete Payments from the WordPress admin panel.  Then click Modify Setup as shown above.

PayPal Complete Payments Settings Menu

WooCommerce Settings

Go to WooCommerce -> Settings -> Payments -> PayPal Complete Payments – Built by Angelleye.

PayPal Complete Payments WooCommerce Settings

Initial Setup

PayPal Complete Payments Initial Setup

Check this box to enable the PayPal Commerce – Built by Angelleye gateway on your WooCommerce website.

Title and Description

These values may or may not be displayed on your WooCommerce checkout page depending on how your theme design is using them.

PayPal Account Settings

PayPal Commerce Platform Connected Successfully
PayPal Sandbox

If you would like to run tests using the PayPal sandbox, check this box to enable this mode.  You will then need to connect a PayPal sandbox seller account to be used for test purposes.

PayPal Connection / Merchant ID

You will see a notice about whether or not you have successfully connected your PayPal account for use.

If not, click the Go to Setup button and follow the steps to connect your account from there.

Location Specific PayPal Button Placement and Display Options

Product, Cart, and Checkout Page

The PayPal button stack provides a variety of ways to control the look and feel of payment buttons on your website as well as the user experience based on the payment type selected.

With Smart PayPal Buttons you can customize the following aspects of your payment buttons:


  • Size, Color, and Shape.
  • Payment types:  PayPal Checkout, PayPal Credit, Credit Cards, and Venmo
  • Layout: Horizontal vs. Vertical button display.

For each section – Product Page, Cart Page, Checkout Page, and Mini-Cart, you can adjust similar options for the way the buttons will “look and feel” on your site.

All of these options are set by default to the best option PayPal recommends specific to the page the buttons will be displayed on.  This is based on split testing the buttons to find the best conversion rates based on the specific location of the buttons.

If you want to adjust these options to better suit your site design / preference, just make the changes, Save, and then reload that page on your site to see the effect.

smart buttons_iphone12black_portrait

This allows you to enable or disable the PayPal button stack on your checkout page.

Checkout Page Display

Choose where to display the PayPal button stack on your checkout page.

Display at the top of the checkout page.
This will place the PayPal buttons above the checkout forms on the page, allowing customers to checkout without filling out the forms.

Display in general list of enabled gateways on checkout page.
This will place the PayPal buttons below the checkout page in the WooCommerce payment gateways section.  Customers will fill out the checkout forms, and would then see PayPal options included along-side any other payment gateways you have enabled in WooCommerce.

Display both at the top and in the general list of gateways on the checkout page.
This will place the PayPal buttons both above and below the checkout.  Customers will have the option to skip the forms and checkout more quickly, or go ahead and fill out the forms and checkout using the options below.

Enable/Disable Smart Buttons

By default, the PayPal button stack uses the “Smart Buttons” when included in the regular list of gateways on the WooCommerce checkout page.

If you prefer to make this more generic like other payment gateways you can disable smart buttons here.

(Not Recommended)

Hide Funding Method(s)

By default, all of the buttons available in the PayPal button stack will be displayed.  This includes PayPal Checkout, Pay Later, Venmo, and Credit/Debit Card.

If you would like to hide any of these methods, add that method here, and that button will be hidden from that location.

Button Options

There are many options for the button layout, color, shape, size, height, label, and tagline.

These are all set based on PayPal recommendations after spliting testing to find the best converting buttons specifically for a checkout page.

If you would like to adjust them to better suit your cart page design you may change the them, save settings, and reload that page on your site to see the result.

PayPal Pay Later Messaging

PayPal for WooCommerce incorporates the most effective ways to promote PayPal Pay Later based on best practices, visuals, and guidelines.

Much like the button options, there are location specific settings available for where and how to display the Pay Later promotions.

Enabling these promotions informs your buyers that you offer these Pay Later services, and can increase conversion rates as well as average order totals.

Please take a look at our detailed article on PayPal Buy Now Pay Later Integration.

PayPal Pay Later Messaging in WooCommerce

Subscriptions (Tokenization)

In order to use plugins like Woo Subscriptions, Funnel Builders, or token payments of any kind, you will need to have the PayPal Vault approved and connected.

Click the button to Connect the Vault, log in to the same PayPal account you initially connected the plugin to, and approve the Vault functionality.

Once you return to the settings and you see a green check mark next to Tokenization / Subscriptions, then you know you’re ready to rock!

Save Payment Method at Checkout

Enable tokenization to give your buyers the option to save their payment method at checkout.  Next time they buy from you, they will see a list of saved payment methods, and they can choose one of those for a fast checkout!

WooCommerce Subscriptions

Once the PayPal Vault is connected on your site, you will be able to use the Woo Subscriptions plugin to create and manage subscription profiles.

This utilizes reference transactions (token payments) so you will have complete control over processing renewals, updating profile details, etc.

Reference Transactions

Create a new order on behalf of your customer, and process it automatically using the previously saved payment information.

Funnels / One-Click Up-sell

Make your upsell funnels shine with one-click payment functionality.  No need to continue logging in or entering CC details.  After the initial payment, a single click triggers another payment…and another…and another…

Apple Pay

In order to provide Apple Pay as a payment option on your WooCommerce website, you will need the functionality approved and enabled for your PayPal account.

If Apple Pay has not yet been approved on your PayPal account you will see a button to Activate it. 

Click the button to Activate Apple Pay, log in to the same PayPal account you initially connected the plugin to, and proceed with approval.

PayPal Activate Apple Pay Button

Once you return to the settings and you see a green check mark next to Apple Pay, then you know you’re good to go, and you can ignore the following Domain Management step.  

PayPal Apple Pay Activated

Domain Management

When you activate Apple Pay, your site domain will be registered automatically with Apple as part of the process. 

If this step fails for any reason, you will need to register your site domain manually.

Click the Manage Apple Pay Domains button and you will be presented with a simple domain manager window:

PayPal Apple Pay Domain Management

Click the link to ensure a page with a bunch of numbers is displayed.  This is the verification page that Apple will use to verify your domain.

Then verify that the Domain Name entered matches your website domain, and click the Add Domain button.

This will register your domain, and then you will be fully approved and active with Apple Pay!

PayPal Apple Pay Domain Registration

Once Apple Pay has been activated and enabled in your PayPal for WooCommerce settings, you will see an Apple Pay button displayed for payment when using an iOS device or Safari browser.

Apple Pay Button

Frequently Asked Questions

For more details about Apple Pay and how it works with WooCommerce, please review our frequently asked questions.

Google Pay

In order to provide Google Pay as a payment option on your WooCommerce website, you will need the functionality approved and enabled for your PayPal account.

If Google Pay has not yet been approved on your PayPal account you will see a button to Activate it.

Click the button to Activate Google Pay, log in to the same PayPal account you initially connected the plugin to, and proceed with approval.

Google Pay Activation

Once you return to the settings and you see a green check mark next to Google Pay, then you know you’re good to go!

Google Pay Activated

Once Google Pay has been activated and enabled in your PayPal for WooCommerce settings, you will see an Google Pay button displayed for payment when using an Android device or Chrome browser.

Google Pay Button

Frequently Asked Questions

For more details about Google Pay and how it works with WooCommerce, please review our frequently asked questions.

Advanced Settings

Payment Action

Payment Action allows you to adjust how you want to process the original transaction.

  • Capture: This option will immediately capture the funds and move the money into your PayPal account.
  • Authorize: This will authorize the funds for the transaction on the buyer’s account, but it will not actually capture the funds and move any money into your account.
    • When you are ready, you may capture the funds for the authorized order from the WooCommerce order screen.

Please take a look at our detailed article on WooCommerce PayPal Authorize and Capture documentation.

Invoice Prefix

The Invoice Prefix option allows you to set a value for the prefix on invoice IDs generated by WooCommerce.

This can help resolve duplicate invoice issues that may arise if you’re using PayPal Complete Payments on multiple websites. 

Skip Final Review

Enable this option to eliminate the additional review page that shows up when PayPal returns a user to your site.

  • The checkout system does not know the buyer’s shipping address until after they have signed in to PayPal. Once they are returned to your site, shipping and tax are calculated based on the shipping address returned by PayPal. A final review page is displayed to break down the buyer’s final totals before completing the order.
  • If you are selling products that do not require shipping and/or tax, you may decide to skip this final review page so that users will complete their payment on the PayPal pages. With this option enabled, PayPal will redirect the users back to your final “checkout complete” page instead of a review page, and there will be no further action required to complete the payment.
Coupon Codes

Enable this option to allow usage of Coupon codes on the Final Review page.

  • Usually, coupon codes are only allowed on the Cart page or the checkout page.
  • Enabling this option will allow the customer to enter a coupon code even after returning from the PayPal payment popup.
Brand Name

This controls what users will see for the brand/company name on PayPal review pages.

Landing Page

With this option, you can choose which type of page the user should see by default when they reach the PayPal login.

  • No Preference: Decided by PayPal based on the customer’s previous logins.
  • Login: This will make the PayPal login option the default option.
  • Billing: This will make the full credit card form the default option and is more obvious to non-PayPal users that they can pay you without creating an account.

Instant Payments

If you enable this setting, PayPal will be instructed not to allow the buyer to use funding sources that take additional time to complete (for example, eChecks).

Instead, the buyer will be required to use an instant funding source, such as an instant transfer, a credit/debit card, or PayPal Pay Later.

Billing Address

When a buyer uses a PayPal Checkout from a product page or the shopping cart page on your site, the application does not know their address because they are skipping the checkout page.

In these cases, PayPal returns a shipping address to the site, and by default, this is the only address that gets saved with the WooCommerce order.  The billing address gets left blank.

Enable this option if you would like the WooCommerce order to populate the billing address using the same address that PayPal returns for shipping

Send Item Details

Check this box to send all of the cart’s line item details and the break-down of shipping, tax, and handling to PayPal.

This will make all of those details show up nicely in the PayPal transaction details screen within your PayPal account.

If you do not want this for any reason, disable this option, and only the order total without any itemized details will be sent to PayPal.

Advanced Credit Cards

PayPal Advanced Credit Cards adds direct credit card processing to your site exacly the same as Stripe, Square,, or any other card processor.

The buyer can choose to “pay with PayPal” if they want, or they can enter the credit card details directly into the Advanced Credit Card gateway.

When using the direct credit card fields they will never be redirected through any PayPal login or pop-up of any kind.  It’s an entirely direct experience for credit and debit card processing.

Also, you get a lower rate of 2.69% when people pay this way vs. the 3.59% that gets charged when people checkout with PayPal!

Check out our blog about Advanced Credit Cards for more details.

Contingency for 3D Secure

Standard payments and advanced credit and debit card payments processing includes support for providing customer authentication with 3D Secure.

Use 3D Secure to authenticate cardholders through card issuers.

It reduces the likelihood of fraud when you use supported cards and improves transaction performance.

A successful 3D Secure authentication can shift liability for fraudulent chargebacks from the merchant to the card issuer.

Enable/Disable Separate Fields for Credit Cards

By default, the Advanced Credit Card fields will be placed immediately below the PayPal button stack, all as part of the same gateway on the WooCommerce checkout page.

Enable this option to separate the PayPal buttons from the direct credit card option, so that they will be two different radio buttons on the checkout page.

Advanced Credit Cards Title

If you have enabled the option to separate the PayPal buttons and the Advanced Credit Card form, this title will be used as the label for the Credit Card option in the WooCommerce gateway options on the checkout page.

Advanced Credit Cards Position

If you have enabled the option to separate the PayPal buttons and the Advanced Credit Card form, this will adjust whether the Credit Card option is displayed before or after the PayPal option.

Disable Specific Credit Cards

If there are any specific credit card types that you do not wish to include on your site, choose them from this list and they will be hidden.

Credit Card Statement Name

Enter the name you would like customers to see on their credit card statement when purchasing from you using Advanced Credit Cards.

Error Email Notifications

Enable this to have an email sent to the site admin account any time a PayPal API error occurs.

Debug Log

Set how you would like to handle PayPal logs.

Log every API request and response regardless of the result.

Errors and Warnings Only
Only save logs if an API error/warning occurs.

Do not save any logs of any kind.

It is recommended that you enable Everything so that we have as much data as possible should we ever need to troubleshoot a problem.

However, you should make it a habit to clear these logs out on a regular basis so that they do not grow large and cause drive space problems on your hosting account.

Looking for Live Help?

Schedule a live meeting with Drew Angell, PayPal Certified Developer, and get all of your questions or concerns answered.