WordPress PayPal plugin connects PayPal to your WordPress site and makes e-commerce available for you. With the WordPress PayPal plugin, you can create various types of buttons such as Add to Cart, Buy Now, Donation or Subscription with a simple shortcode to accept PayPal payments from your users. This plugin allows both one-time and recurring subscription payments so you can run your online store with great ease.
WP PayPal plugin uses the PayPal Payments Standard API to create a checkout process for your customer that is fast, easy, and intuitive. With one simple shortcode, you can add a secure payment button to your website that lets you accept credit card, debit card, and PayPal payments from any mobile device, tablet, or PC.
Features
- Accept PayPal and PayPal Credit (US only) payments
- No monthly fee
- Accept credit cards and debit cards
- Optimized mobile checkout experience
- Accept one-time or recurring payments
- Simplified PCI compliance
- Accept donations
- OneTouchTM enables checkout with a click of a button
- Accept 25 currencies from over 200+ countries and markets
How to Install PayPal in WordPress
- Login to your WordPress admin dashboard
- Go to Plugins->Add New
- Enter WP PayPal in the search box
- Once you find the plugin hit the install button
Option 2
- Download the zip version of the plugin
- Go to Plugins->Add New and switch to the Upload tab
- Select the zip file on your computer
- Upload and install it
Option 3
- Download the zip file and extract it
- Connect to your website via FTP (you can use a software like Filezilla to transfer files to your server) and browse to the “/wp-content/plugins” folder
- Select the folder containing the plugin files on your computer and upload it
- Once all the files have been uploaded to your web server you can activate the plugin from the Plugins menu (WordPress admin dashboard)
How to Configure PayPal in WordPress
Here is a video that shows how you you can set up PayPal in WordPress with the WP PayPal plugin.
In order to create a button, you need to insert a shortcode and specify the type in the button parameter.
Buy Now
[wp_paypal button="buynow" name="My product" amount="1.00"]
Add to Cart
[wp_paypal button="cart" name="My product" amount="1.00"]
View Cart
[wp_paypal button="viewcart"]
Donation
[wp_paypal button="donate" name="My product"]
Subscription
[wp_paypal button="subscribe" name="My product" a3="1.00" p3="1" t3="M" src="1"]
For subscription setup see how to create a subscription button in WordPress.
PayPal Button Demo
PayPal Button Customizations
Button Image
“button_image” parameter can be added to the shortcode to show your own button image instead of the default PayPal button. For example:
[wp_paypal button="buynow" name="My product" amount="4.99" button_image="https://example.com/images/buy.png"]
Shipping
“shipping” parameter can be added to the shortcode to charge shipping for an item. For example:
[wp_paypal button="buynow" name="My product" amount="4.99" shipping="1.75"]
Shipping2
“shipping2” parameter can be added to the shortcode to charge shipping for each additional unit of an item. For example:
[wp_paypal button="buynow" name="My product" amount="4.99" shipping="1.75" shipping2="0.75"]
This means, If a user orders:
My Product (Quantity 1), total shipping would be $1.75.
when the order becomes:
My Product (Quantity 2), total shipping would be $1.75 + $0.75.
When it contains:
My Product (Quantity 3), total shipping would be $1.75 + $0.75 + $0.75.
And so on.
This feature is also very useful if you want to offer shipping at a discounted rate for each additional item.
Tax/GST
“tax” parameter can be added to the shortcode to charge GST for an item. For example:
[wp_paypal button="buynow" name="My product" amount="4.99" tax="2.15"]
Handling Fees
“handling” parameter can be added to the shortcode to charge handling fees for an item. For example:
[wp_paypal button="buynow" name="My product" amount="4.99" handling="2.50"]
This parameter is not quantity-specific. That means the same handling cost applies, regardless of the number of items on the order.
Success Page
“return” parameter can be added to the shortcode to redirect the user to a specific page on your site after the payment. For example:
[wp_paypal button="buynow" name="My product" amount="4.99" return="https://example.com/thank-you"]
Cancellation Page
“cancel_return” parameter can be added to the shortcode to redirect the user to a specific page on your site if they cancel checkout before completing the payment. For example:
[wp_paypal button="buynow" name="My product" amount="4.99" cancel_return="https://example.com/payment-canceled"]
Currency
To use a different currency code than the one you specified in the settings, you can add the “currency” parameter to the shortcode. For example:
[wp_paypal button="buynow" name="My product" amount="4.99" currency="SGD"]
Show/Hide Shipping Address
“no_shipping” parameter can be added to the shortcode to control whether or not to prompt buyers for a shipping address. Allowable values are,
- 0 – Prompt for a shipping address but do not require one (This option is set by default)
- 1 – Do not prompt for a shipping address
- 2 – Prompt for a shipping address and require one
For example:
[wp_paypal button="buynow" name="My product" amount="4.99" no_shipping="1"]
Shopping URL
“shopping_url” parameter can be added to the shortcode to redirect buyers to a page when they click the Continue Shopping button on the PayPal Shopping Cart page. This parameter can only be used with an Add to Cart/View Cart button. For example:
[wp_paypal button="cart" name="My product" amount="4.99" shopping_url="https://example.com/shop"]
Allow Buyers to Specify the Quantity
“undefined_quantity” parameter can be added to the shortcode to allow buyers to specify the quantity of the item on the Paypal payment page. This parameter is only used with a Buy Now button. For example:
[wp_paypal button="buynow" name="My product" amount="4.99" undefined_quantity="1"]
Open PayPal Button in a New Window/Tab
“target” parameter can be added to the shortcode to open a PayPal button in a new window or tab. For example:
[wp_paypal button="buynow" name="My product" amount="4.99" target="_blank"]
Manage PayPal Orders
When you receive a new order it will appear in the Orders menu. You can then do the following to finalize it:
1) Send a purchase confirmation email to the customer (include download links if applicable)
2) Ship the goods
WP PayPal Extensions
WP PayPal plugin comes with various extensions that you can use to enhance its functionality on your website.
Custom Buy Now Amount
With this extension, your buyers will be able to purchase an item with a custom price.
All you need to do is install this extension and leave the amount parameter empty in the shortcode.
[wp_paypal button="buynow" name="My product" amount=""]
Buy Now Discount
Buy Now Discount extension allows you to offer various automatic discount options with your WP PayPal Buy Now buttons.
Product Variations
Product variations extension can be used to set up variations for your WP PayPal buttons.
Premium Support
Additional Resources
Subscription Button
Frequently Asked Questions
Why is my PayPal payment pending?
If you have sent a PayPal payment that is pending, it’s possible the recipient hasn’t accepted it yet. This may happen if the recipient’s account is configured to review each payment that they receive. It can also happen if the payment is made in a currency that is different from the recipient’s primary currency. In that case the recipient will need to manually review the payment by either converting it to the primary currency or create a new balance in the payment currency. If recipient approves the payment once they will be able to receive payments in that currency in the future automatically.
John Brailsford says
Hello, I am using Version 1.2.2.7 of the plug-in. From it’s description it would do exactly what I wanted so I installed it and did some tests. All went well until I tried to use the ‘return’ & ‘cancel_return’ parameters.
Eventually, by viewing the page source, I discovered that those 2 parameters were not included with the other shortcode parameters. This turned out to be a space that had appeared in the urls which I hadn’t spotted due to line wrapping in the editor. It now works great on my live website so I copied it to my dev site to amend and use for another payment. I’m now back to where I was – it ignores ‘return’ & ‘cancel_return’ and cannot find out why. Any advice to track down the problem would be greatly appreciated. Thanks.
Noor Alam says
@John, Please provide the shortcode and a link to the page in question so I can check it.
John Brailsford says
Hi, I made a simple test page and took out all the parameters generated by code.
The following the page just has the following in a Classic Editor:
[wp_paypal button="buynow" name="Pitch Booking" amount="10" no_shipping="1"
return="https://dev.swift-owners-club.com/index.php/test-pp-response?res=complete&id=100"
cancel_return="https://dev.swift-owners-club.com/index.php/test-pp-response?res=cancelled&id=100"
button_image="https://www.paypalobjects.com/webstatic/en_US/i/buttons/buy-logo-large.png"]
When I run this it shows the correct info in PayPal and claims a payment has been made but that never appears in my test store. There’s also no cancel button and the Return to Seller button doesn’t work!
Noor Alam says
@John, The shortcode looks broken. Please copy it from here and paste as plain text:
[wp_paypal button="buynow" name="Pitch Booking" amount="10.00" no_shipping="1" return="https://dev.swift-owners-club.com/index.php/test-pp-response?res=complete&id=100" cancel_return="https://dev.swift-owners-club.com/index.php/test-pp-response?res=cancelled&id=100" button_image="https://www.paypalobjects.com/webstatic/en_US/i/buttons/buy-logo-large.png"]
Do you have the debug option enabled in the settings? The log file will show if the plugin is receiving notifications from PayPal.
Jhowell Corotan says
So, ive test the plugin.. it works at first few months..
but right now.. its not posting on the “ALL ORDERS” the successful payments made?..
Noor Alam says
@Jhowell, Please enable debug, reset the log and make a test purchase so I can check it.
Jhowell Corotan says
So, i did went through enabling the debug and reset the log.. and it says
[June 21, 2021 6:39 pm] – SUCCESS : Log reset
But when I checked on my paypal accounts payments been made after that.. but still no posted orders on the “ALL ORDERS” the successful payments made..
Tried, deleting the plugin and reinstalling em again.. but still doesnt work.. good thing is payments goes through the my paypal account.. but yeah, just wanted to check on the orders without checking it over my paypal account..
Noor Alam says
@Jhowell, Do you have IPN enabled in your PayPal account?
Javier says
Hello, is it possible to use this payment method for a marketplace made in woordpress setting a commission for the wordpress administrator? That is, I create a markeplace-style web, so that 2 registered users agree and a transaction is made between them. A% of that transaction would remain in an account of the web administrator.
Thanks and Regards
Noor Alam says
@Javier, Unfortunately that’s not possible with this plugin.
John Kofroth says
I added the button_image parameter but the picture does not show up.
Noor Alam says
@John, Have you fixed it? I can see the button image now.
John Kofroth says
No I can’t get the custom image to work. Apparently the plug-in I was using is not supported by this forum.
I am now using a different plug-in.
saundie says
?works great on desktop and tablet but buttons will not work on mobile phone
John Kofroth says
Works ok for me.
Scroll down and click the collection plate.
slin says
Hello,
is this still working?
It took me a year or two to find the bl**dy Merchant-ID, but I found it, I guess.
When I click the button I get a paypal page saying there was a system error
Here’s my code:
[wp_paypal button="buynow" name="N-Taxi Ride #123" amount="99.00" tax="15.81" return="https://myurl" cancel_return="https://myurl"]Any ideas?
Noor Alam says
@slin, The merchant ID is for users who don’t wish to show their email addresses. You can still accept payments by using your merchant email address.
Please provide a link to the page where you have the button.
slin says
Thanks for getting back at me, I fixed it.
The problem was Paypal, hiding the merchant id and things. I hate that. They are not very helpful.
If you can include some description of how/where to find the ids and addresses to the readme, future new users might appreciate it… 🙂
Thanks for your work!
John Brailsford says
I need to update the payment status in my database on success or failure after returning from PayPal to a page on my website. To achieve this I pass a reference ID on the return and cancel_return urls which is subsequently used to update the database. Most of the time it works OK and it returns my reference ID plus the payer_id which presumably PayPal adds by default.
Unfortunately, it seems that it doesn’t always return to my site and therefore prevents me from updating my database. I have contacted the buyers and it looks like they used Debit/Credit cards rather than personal PayPal accounts to make payment. I can’t easily check if any transactions with cards did return OK.
Your advice would be appreciated. Thanks.
John Willis says
I’ve followed your demo a number of times now and pasting in your buy now shortcode just creates the buy now button and nothing about My product, I’m pasting in
[wp_paypal button="buynow" name="My product" amount="1.00"].I followed your youtube example precisely.Noor Alam says
@John, Can you please describe the issue?
John Willis says
Sorry Noor, I was somehow expecting that the ‘my product’ and price would show up on my website after the button, but I now see that that my product and price only show up on the PayPal website after you click the button. My mistake.
josephus says
Hi,
I’m using these three buttons, but when pushed I get a PayPal site
https://www.paypal.com/webapps/shoppingcart/error?flowlogging_id=a876f5c14a36f&code=BAD_INPUT_ERRORwhich says; Le système ne fonctionne pas pour le moment. Réessayez plus tard.
[wp_paypal button="buynow" name="aprem" amount="100.00" currency="EUR"]
[wp_paypal button="buynow" name="jour" amount="125.00" currency="EUR"]
[wp_paypal button="buynow" name="nuit" amount="150.00" currency="EUR"]
Can you help me?
tnx, Josephus
Noor Alam says
@josephus, Please provide a link to the page where you are using these shortcodes.
josephus says
https://donjonmontblanc.com/?post_type=productthank you for your time and effort
Noor Alam says
@josephus, Thanks. Your Merchant ID is set to “Les poules de roche tailla” in the plugin settings? It should be a 13-character unique ID that you can find your PayPal account. Alternatively, you can leave the Merchant ID field empty and the plugin will use your PayPal email address instead.
josephus says
that is the name of my company, of my PayPal pro account
deleted the name and it works, thank you, I’ve been stuck for two days on this…
CU, Josephus
Johnny says
Hello great plugin works nicely!
Is there any way to add options on the Buy Now or Add to Cart buttons?
Like we want to sell T-shirts, so if they can select Small, Medium, Large, Extra Large options.
We don’t need the price to be different, but if there’s a way to do that as well great!
Sandro says
SandBox mode
[wp_paypal button="buynow" name="Corso B" amount="20.00" return="https://www.stranamente.net/downloadcorsob"]
does not return the DownloadCorsoB page but a page containing the message
Your payment has been completed. To continue shopping, return to the seller’s site.
what’s the problem ?
Thanks
Noor Alam says
@Sandro, PayPal users the return URL in the return to the seller’s site link.
Sandro says
Hi,
I have to write:
return="https://www.stranamente.net"]?I would like to perform a download after paying to download documents
how can I do ?
Thanks
Noor Alam says
@Sandro, I mean there should be a link on the PayPal payment page to return to your site. That link is the URL that you specify in the shortcode.
There is no automatic download option in this plugin.
Sandro says
hi,
I don’t understand … I don’t want to do any automatic downloads; I simply want, after paying with PayPal, to go to a page that contains a button to make a download, which will be done by the user.
return = "https://example.com/thank-you"what is the problem if the “thank-you” page contains a message or a button to make a download , not automatic ?
The Paypal button of Elementor 3.4, after a payment, accepts the redirection to a page containing a download, but during the payment it produces a recoverable error.
I apologize, but I have tried 3 plugins and all of them, either for one reason or another, do not allow me to do such a simple thing: make a payment and then go to a page that contains a button to make a download.
Noor Alam says
@Sandro, Please provide the following information:
1) Link to the page where you have the button
2) Screenshot of the PayPal page after the payment
David says
Thanks for the easy to use plugin. One question. When I add the button to my page, it takes me to a paypal hosted page and asks the user to login to their paypal account or to create an account. I don’t see the option for the user to pay using a debit/credit card without having to login or create a paypal account.
Is there a way around this? I dont want to force my users to create a Paypal account.
Noor Alam says
@David, PayPal shows this option if the user chooses to “create an account”.
Eric Berlin says
Thank you for this superb plug-in. One question: Is it possible to set up the *automated* sending of a purchase confirmation email to the customer, including appropriate download links?
Noor Alam says
@Eric, It’s not possible at the moment. You may want to look into an advanced e-commerce plugin for this functionality.
Irina Ghazazyan says
For some reason the plugin doesn’t work on my webiste. After adding and saving my merchant ID in the plug-in settings, I could install Paypal button on my website, but unfortunately it doesn’t work. The plugin notification I see is as follows:”Please enter your PayPal Account or Merchant ID on the settings pages” which is actually installed.
I would really appreciate your help with this issue.