ThemeHigh
  • Plugins
  • Documentation
  • Support
  • Partners
  • Login
  • Getting started Paypal
    • Setup Guide – Payment Gate...
    • Set Up PayPal Direct Credit Card...
    • Accept PayPal Payments Using Pay...
    • Accept PayPal Payments using Pay...
  • Subscriptions
    • Configure PayPal Subscription Pa...
  • Customizations
    • Customize PayPal Credit/Debit Ca...
    • Adding a PayPal Express button o...
  • Whats New?
    • Configuring Webhooks for WooComm...
    • PayPal: Alternative Payment Meth...
  • Issue Refund
    • Manage PayPal Refunds in WooComm...
  • Switching CheckOut Pages
    • Switching to Classic Checkout in...
  • Troubleshooting Guide
    • Trouble Shooting Guide...

Documentation/PayPal Payment Gateway WooCommerce/Setup Guide – Payment Gateway Plugin for PayPal WooCommerce

Setup Guide – Payment Gateway Plugin for PayPal WooCommerce

Last updated on October 28, 2025

The Payment Gateway Plugin for PayPal WooCommerce enables WooCommerce online store owners to easily integrate secure payment processing into their sites. This guide will take you through the complete setup and configuration of the Payment Gateway Plugin for PayPal WooCommerce on your WooCommerce site. 

 

Features offered

 

  • Complete your purchase using PayPal Smart Buttons or Express Buttons.  
  • There’s extensive customization available for PayPal Smart Payment Buttons.  
  • It automatically identifies the customer’s country and shows the payment options.  
  • Quickly check out with the PayPal Express Button, using saved shipping and payment details from the user’s PayPal account.

Getting started

After the plugin has been installed and activated:

  • In the WordPress dashboard, go to WooCommerce > Settings > Payments > PayPal Express.
  • Click on the Manage button.

Plugin navigation

  • Alternatively, go to the WordPress dashboard, then head to Plugins > Installed Plugins > Payment Gateway Plugin for PayPal WooCommerce > Settings.

Select the PayPal payment option.

Using the plugin, you can receive PayPal payments through two methods:

PayPal payment methods

 

PayPal Smart Button

PayPal Smart Payment Buttons are rendered using the PayPal API. It allows customizing the smart buttons in different ways. The alternative payment methods accept payments by using local funding sources based on the country.

Please note that:

  • Smart Payment buttons will not support Subscriptions.
  • Also, it will override the existing customisations done for Express buttons.

Smart Button

Using PayPal’s Smart Button, you can accept payment from customers using multiple Alternative Payment Methods (APM). With Alternative payment methods, customers can pay with their bank accounts, wallets, and other local payment methods based on country or device such as:

  • Bancontact
  • BLIK
  • eps
  • iDEAL
  • MyBank
  • Pay upon Invoice
  • Przelewy24

Paypal Credentials

To utilize the WooCommerce PayPal Smart Payment Button, you need a PayPal business account. You can set up a Live or Sandbox account at no cost.

PayPal Credentials

Get Client ID and Secret from your PayPal account.

PayPal Webhook Credentials

Here are the credentials to register your site’s webhook with PayPal and receive updates on WooCommerce order statuses.

PayPal Webhook Credentials

PayPal Webhook URL: This part shows your site’s webhook URL. Use this URL to set up your site’s webhook with PayPal. To do this, go to PayPal Developer Dashboard > Apps & Credentials > Preferred App > Live/Sandbox Webhooks > Add webhook. Here, enter the PayPal webhook URL and choose the event types. For more details, check the article: Configuring Webhooks for WooCommerce Order Status Updates.

PayPal Webhook ID: When you register the site’s webhook with PayPal, you will receive a webhook ID. Enter the PayPal webhook ID here.

PayPal Credentials

  • Title – Title for the payment gateway displayed at the checkout.
  • Description – Description of the payment gateway displayed at the checkout.

Smart Buttons – Customization

The following are the available customization options:

  • Activate the Smart button – List the pages where the smart button can be shown. The available choices are:

Cart page

Checkout page

  • Description – Text displayed above the Smart button.

Size – Outlines the button sizes offered for the Smart button. Options include:

Button size

Button labels – Displays a set of predefined labels from PayPal that can be shown as Button labels. The options include PayPal, Buy Now, Pay, and Checkout.

Smart button labels

  • Tagline – You can choose to show or hide the tagline. Note that it will be hidden for the vertical layout.Tagline for Smart button
  • Button color – Displays the color choices for the Smart button. The options are Gold, Blue, Silver, White, and Black.

Button color for smart button

Shape – Provides a list of shape options for the Smart button. The options available are Pill or Rect.

Button shape for smart button

Layout – Enumerate the layout choices available for the Smart button.

Button layout for smart button

 

Turn off a funding source – Show the payment options available in your PayPal account. The chosen payment option will be deactivated. Note: The checkout displays funding sources depending on the country or type of device.

 

Take a look at the article below for more information on accepting payments with the PayPal Smart Button.

 

PayPal Express Checkout Button

Enable the PayPal Payment Gateway and Express Button

By implementing the PayPal Express Checkout Button, your customers can swiftly complete their purchase using the shipping details and payment method already saved in their PayPal accounts. They won’t need to enter any information again— which saves time and lowers shopping cart abandonment.

PayPal credentials

To utilize the WooCommerce PayPal Express Checkout Button, you need a PayPal business account. You can create a Live or Sandbox account at no cost.

Paypal Express Checkout Button –Customizations

The following are the customization options:

Paypal Express Checkout Button - Settings

 

  • Show Express button on – A list of pages that can display the PayPal Express button.  
  • Show Express Credit button on – Displays a PayPal Express Credit button on chosen pages. By using PayPal Credit, store owners get the payment immediately, while customers can choose to finance and pay gradually.The express button on the cart page will appear as shown below:

PayPal Express Button-Cart page

The express button on the product page will look like the image below. The buyer can complete their purchase straight from the product page. Clicking the Checkout with the PayPal button/PayPal Credit will take the buyer to the PayPal website.

PayPal Express Button-Product page

  • Description – The text shown above the PayPal Express button.
  • Type of Checkout – Select the type of PayPal checkout type. The available options are as given below:
    • Redirect to PayPal – Choose ‘Redirect to PayPal’ to open PayPal in the same window from the cart or checkout page.
    • In-Context Flow PayPal –   Choose ‘in-context flow’ to open PayPal in a new window from the cart or checkout page. In an in-context flow.
  • Once the customer clicks the Checkout with PayPal button.
  • The PayPal popup window is displayed as shown below.
  • The customer must enter the PayPal login credentials and pay the order amount. 

PayPal login page

  • Button Settings:  
    • Position – Display the available locations for PayPal Express/Credit Card checkout buttons. The options are:
      • Above – Shows PayPal Express/Credit Card checkout buttons above the Add to Cart (on the product page) or Proceed to Checkout (on the cart page).
  • Below – Shows PayPal Express/Credit Card checkout buttons underneath Add to Cart (Product page checkout) or Proceed to Checkout (Cart page checkout).
  • Size – You can choose the size for the PayPal Express/Credit Card button. The options available are listed below:
    • Small
    • Medium
    • Large
  • Style – The design of PayPal Express/Credit card checkout buttons from the dropdown menu. The options available are listed below:
    • PayPal Style – Shows PayPal Express/Credit Card checkout buttons in the PayPal design.  
    • WooCommerce Style – Shows PayPal Express/Credit Card checkout buttons in the WooCommerce design, matching the style of Add to Cart / Proceed to Checkout.

PayPal CREDIT button

 

At last, save the configurations.

Take a look at the article below for more information on accepting payments with the PayPal Express Button.

Common settings

Branding

Establish your brand identity on the PayPal platform by submitting a brand name, logo, banner, etc. Customers selecting PayPal for payment will view this on the PayPal site.

Customization options

The configurations are displayed below:

 

  • Brand name – Name of the store to show on the PayPal side.  
  • Landing page: Directs customers to the selected page. By default, it goes to the billing page.  
  • Logo (190×90): Upload a company logo that will display on the PayPal side. The image needs an SSL host.
  • Header(750×90): Upload a header image that will appear on the PayPal end. The image requires an SSL host.
  • PayPal locale:
    • Use Store Locale: Choose to set the PayPal locale the same as the store locale.
    • Use Specific Locale: Choose to set a different locale other than store locale for the PayPal locale. (Drop down lists down the languages supported by PayPal)

The logo will appear at the PayPal end, as shown below:

PayPal payment window

Advanced Settings

Advanced options

  • Instant payment – Turn off the option for buyers to use funding methods that take longer to process (like eChecks). Keep the option active for accepting payments through instant transfer, credit/debit cards, or PayPal Credit.
  • Payment action – 
      • Sale – captures funds immediately.
      • Authorize – checks if funds are available and later captures the payment. The shop owner can capture payment directly from the individual WooCommerce order page. The shop owner/admin can also capture the payment from the PayPal Express Action box.
  • Authorize or Capture payment from the order page – You can place a hold on a card to reserve funds now but only capture them after your business completes the service. For example, a hotel may want to authorize payment in full prior to a guest’s arrival, then move the money when the guest checks out.
    • When a payment gets authorized, the card issuer guarantees the funds, holding the amount on the customer’s card for up to seven days. If the payment isn’t captured within that period, both the PaymentIntent and authorization are canceled, and the funds are released.The store admin can capture the payment from WooCommerce > Orders >    Individual Order. The Order page appears as shown below:

Order Capture

In the PayPal Express Action box, click Capture to retrieve the order payment. Once captured, the payment for the order will be successfully received.

 

  • Invoice Prefix – Enter a prefix for invoices to distinguish transactions from your site. For example, if you input Extensionhawk_ in this field, the Invoice Number will be Extensionhawk_12098.
  • Address override – Activating this will stop the checkout address from being altered at PayPal’s side. It will influence express checkout, and PayPal will rigorously check the address.
  • Shipping information – Activate the option to send shipping details to PayPal rather than billing. PayPal permits the sending of only one address, either shipping or billing. We recommend verifying PayPal Seller protection to transmit shipping details to PayPal.
  • On payment cancel – Canceling express payment will redirect customers to the chosen page.
  • Back to Previous Page: Takes the customer back to the page they came from before going to PayPal.
  • Redirect to Custom Page: Directs the customer to customize the page from PayPal. Enter the URL of the customized page in the Cancel Redirect Page URL field.
  • Skip review page – Allow skipping the review page to go straight to the site. The plugin gives you the ability to review the order before finalizing it. On the review page, customers can choose to place or cancel the order. The setting is displayed below:

 

  • Seller Policy: This field shows up if you don’t skip the Review page. Type in the Seller Policy or any personalized text you’d like to appear on the Review page for the customer.
    • On placing an order, the buyer is directed to Review Page of Order ( if not skipped in Admin settings) as shown below.
    • The buyer can Place / Cancel the order by clicking the respective buttons.

Order preview page

Debug Logs

Records PayPal payment transactions into WooCommerce status log

  • Log: Enable to record PayPal payment transactions in a log file.

Finally, click Save changes to save/update the plugin settings.

This way, the customer can place the order securely by paying through PayPal. For more details on the plugin, check out our PayPal Express Checkout Payment Gateway for WooCommerce.

On this page

  • Getting started
  • Select the PayPal payment option.
  • PayPal Smart Button
  • Paypal Credentials
  • PayPal Webhook Credentials
  • Smart Buttons – Customization
  • PayPal Express Checkout Button
  • Enable the PayPal Payment Gateway and Express Button
  • PayPal credentials
  • Paypal Express Checkout Button –Customizations
  • Common settings
  • Branding
  • Advanced Settings

This article posted in Getting started Paypal, PayPal Payment Gateway WooCommerce, Pro Documentation

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

ThemeHigh

We develop innovative WordPress plugins and themes for e-commerce and other WordPress websites.

Resources
  • Documentation
  • Support
  • Blog
  • Bestsellers
  • Affiliates
  • Partners
Policy Information
  • Terms & Conditions
  • Privacy Policy
  • Support Policy
  • Refunds Policy
  • Licenses
Security
Payment Options

© 2026 ThemeHigh. All rights reserved.

Terms and conditions, features, support, pricing, and service options subject to change without notice.