WordPress PayPal


WordPress PayPal plugin allows you to easily create PayPal Buy Now, Add to Cart, Donation or Subscription type buttons. It generates dynamic buttons using shortcodes that enable PayPal checkout on your WordPress site.

Your customers will be able to pay for your products using PayPal or Credit Card. This plugin makes it easy for you to set up your online e-commerce store. You do not need to spend days configuring products and settings. All you need to do is insert a shortcode into one of your web pages and your website will be ready to go live.

WP PayPal supports PayPal Sandbox. PayPal Sandbox is a simulation environment which allows you to do test purchases between a test buyer and a seller account. This is to make sure that your store can process PayPal transactions without any issues. It also helps you get prepared before selling to real customers.

WP PayPal Features

  • Sell products or services using PayPal
  • Create PayPal buttons on the fly in a post/page using shortcodes
  • Accept once off payments or recurring payments
  • Accept donations from users
  • Allow users to add multiple items to the shopping cart and checkout
  • View or Manage orders received via PayPal buttons from your WordPress admin dashboard
  • Quick settings configurations
  • Enable debug to troubleshoot various issues (e.g. orders not getting updated)
  • Accept subscriptions on a daily, weekly, monthly or yearly basis
  • Sell items with different variation options (e.g. size, color, price)
  • Switch your store to PayPal sandbox mode for testing
  • Compatible with the latest version of WordPress
  • Compatible with any WordPress theme
  • Sell in any currency supported by PayPal
  • Accept recurring payments/subscriptions
  • Charge shipping on your products or services
  • Charge tax on your products or services

How to Use WP PayPal

Once you have installed this plugin you need to go to the settings menu to configure some default options (WP PayPal -> Settings).

  • PayPal Merchant ID: Your PayPal Merchant ID
  • PayPal Email: Your PayPal email address
  • Currency Code: The default currency code

In order to create a button insert the shortcode like the following:

PayPal Buy Now

Buy Now buttons are for single item purchases. In order to create a buy button you need to specify it in the button parameter of the shortcode.

[wp_paypal button="buynow" name="My product" amount="1.00"]

PayPal Add to Cart

Add To Cart buttons let users add multiple items to their PayPal shopping cart and checkout.

[wp_paypal button="cart" name="My product" amount="1.00"]

PayPal View Cart

View Cart buttons let users view items that were added to their PayPal shopping cart.

[wp_paypal button="viewcart"]

PayPal Donation

Donation buttons let you accept donations from your users.

[wp_paypal button="donate" name="My product"]

PayPal Subscription

Subscribe buttons let you set up payment subscriptions.

[wp_paypal button="subscribe" name="My product" a3="1.00" p3="1" t3="M" src="1"]<h3>PayPal Button Parameters</h3>

You can use additional parameters to customize your PayPal buttons.

  • type – The type of button to render (e.g. «buynow», «cart», «donate» or «subscribe»)
  • name – Description of the item.
  • button_image – Your custom button image URL (e.g. button_image=»https://example.com/images/buy.png»).
  • number – The number of the item (Also known as SKU. e.g. number=»16″).
  • amount– The price of the item (e.g. amount=»4.95″).
  • currency – The currency of the item (e.g. currency=»USD»).
  • quantity – Quantity of items to purchase (e.g. quantity=»2″).
  • shipping – The cost of shipping this item. (e.g. shipping=»0.75″). If you specify «shipping» and «shipping2» is not defined, this flat amount is charged regardless of the quantity of items purchased.
  • shipping2 – The cost of shipping each additional unit of this item (e.g. shipping2=»1.25″)
  • tax – Transaction-based tax override variable (e.g. tax=»2.99″).
  • locale – The desired locale of the PayPal site (e.g. locale=»GB»). This feature is useful if you want to render the payment page in a specific language.
  • return – The URL to which the user will be redirected after the payment (e.g. return=»https://example.com/thank-you»).
  • cancel_return – The URL to which PayPal will redirect the buyer if they cancel checkout before completing the payment (e.g. cancel_return=»https://example.com/payment-canceled»).
  • no_shipping – This parameter allows you to control whether or not to prompt buyers for a shipping address (e.g. no_shipping=»1″). Allowable values: 0 – Prompt for an address, but do not require one (This is set by default), 1 – Do not prompt for an address, 2 – Prompt for an address, and require one.
  • undefined_quantity – Allow buyers to specify the quantity of the item on the payment page (e.g. undefined_quantity=»1″). This option is only used with a Buy Now button.
  • target – This parameter allows you to open a PayPal button in a new window or tab (e.g. target=»_blank»).
  • shopping_url – This parameter allows you to customize the Continue Shopping URL for the View Cart button (e.g. shopping_url=»https://example.com/shop»).

PayPal Add to Cart Button/Shopping Cart Specific Parameters

  • handling – Handling charges. This parameter is not quantity-specific, which means the same handling cost applies, regardless of the number of items on the order. (e.g. handling=»2.00″).

For detailed documentation please check out the WordPress PayPal Plugin page.


If you are a non-English speaker please help translate WP PayPal into your language.

Additional PayPal Documentation


  • PayPal Button Demo
  • PayPal Orders


  1. Go to the Add New plugins screen in your WordPress Dashboard
  2. Click the upload tab
  3. Browse for the plugin file (wp-paypal.zip) on your computer
  4. Click «Install Now» and then hit the activate button


Can I accept PayPal payments in WordPress using this plugin?



Oktabr 3, 2021
This plugin is simple to use and works great. Also, the author is prompt in responding to questions and is extremely helpful.
Yanvar 7, 2021
I used different paypal plugin, this one has the most options and works perfectly!
Avgust 26, 2020
Great Plugin but i have some weird issue regarding payment like i have used my sandbox account for payment and it works successfully . But in my transaction list it doesn't show any list for transaction. Will you please help me with this issue. https://prnt.sc/u6awg7 https://prnt.sc/u6awpn
Iyul 27, 2020
The plugin saved me a lot of work. My questions were answered very quickly and competently. Thank you for the great support and greetings from Germany.
Iyun 30, 2020
The initially did not work: "Things don't appear to be working at the moment. Please try again later." Then, it started working suddenly, but I couldn't test it because PayPal wouldn't let me login. PayPal told me to upgrade to a business account. I re-entered my email address and merchant ID, then I am back to "Things don't appear to be working at the moment. Please try again later." I swear my credentials are correct. This plugin is so damn finicky. Do I need a personal PayPal account for this to work?
Read all 33 reviews

Contributors & Developers

“WordPress PayPal” is open source software. The following people have contributed to this plugin.


“WordPress PayPal” has been translated into 13 locales. Thank you to the translators for their contributions.

Translate “WordPress PayPal” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.


  • Added support for product variations extension.

  • Added support for trial period 2 in the PayPal subscription button.

  • Added the shopping_url parameter for the View Cart button.

  • Removed unused JS from the plugin.

  • Added the notify_url parameter to send instant payment notification to a different URL.

  • Made the shopping_url parameter available for add to cart type buttons.

  • Made some security related improvements in the plugin

  • The plugin now shows more error messages if it fails to insert/update an order.

  • Merchant ID can now be entered in the plugin settings.

  • Added a view cart button for the PayPal shopping cart.

  • Charset is now set to utf-8 for all the buttons.


  • Fixed an issue where the add to cart button would open a new tab.


  • Shipping address is now displayed on a separate row in the order content area.


  • Updated the parameters in the subscribe button. This should fix the button image rendering issue on some websites.


  • Donate buttons now support the no_shipping parameter.


  • Made some improvements to the donate button.


  • Made some improvements to the orders menu.


  • Added support for custom field in the shortcode.


  • An action is now triggered after processing the PayPal ipn.


  • Fixed a warning notice in the orders menu.


  • Fixed a bug where the target attribute was not working.


  • Made some improvements to WP PayPal orders.


  • Made some improvements to the PayPal Buy Now button.


  • Fixed this admin notice: screen_icon is deprecated since version 3.8.0 with no alternative available.
  • Made some improvements to the add to cart functionality.
  • Fixed a PayPal error that occurred when an item was added to the shopping cart: Things don’t appear to be working at the moment. Please try again later.


  • Added an option to open a PayPal button in a new window or tab.


  • Fixed a bug where queries could be performed on orders on the front end.
  • WP PayPal orders are now also excluded from search.


  • Added a new action hook which will get triggered once the payment is processed by the plugin.
  • Added a new shortcode parameter to customize the default PayPal button.


  • Fixed an issue that was causing subscription payments to not get processed.


  • Fixed an issue that was causing this error – «Cannot load wp-paypal settings».


  • Made some improvements so language packs can be enabled


  • Fixed a minor bug in the settings which was causing this error: «You do not have sufficient permissions to access this page».
  • Plugin strings are now translatable.


  • PayPal Button plugin is now compatible with WordPress 4.3


  • First commit