PayPal Integration
Important PayPal API Update Available - June 2023
Integration Update Notice (June 2023)
Attention Merchants, UltraCart has a new integration with PayPal, please upgrade to the latest integration in order to take advantage of the new functionality and better user experience that the new integration provides: Upgrading the latest PayPal payment processing integration
IMPORTANT: PayPal is requesting that merchants using the deprecated API to begin the migration to the current API as they will be shutting down the legacy API in the near future.
Benefits
Improved checkout experience for customers using a modal instead of a browser redirect.
Improved analytics tracking because customers are not redirected off domain for PayPal.
Additional payment options for customers including PayPal PayLater and Venmo
Dual Vaulted payment information for credit cards, PayPal, and Venmo.
Superior subscription rebilling initiated from UltraCart
Ability to adjust anything on an auto order paid for with PayPal.
Storefront Theme Pre-Requisites
A StoreFront Visual Builder based theme is required for enabling PayPal in your checkout.
We recommend making sure your theme is updated to the latest available version.
Supported themes are:
Elements - 2.13+
Hero - 1.17+
Jewel - 1.13+
Lifty - 1.15+
Native - 1.12+
Natural VB - 1.12+
Poppy - 1.03+
Merchants Operating multiple UltraCart accounts
The same PayPal business account should not be associated with multiple UltraCart accounts. Merchants that are operating several UltraCart stores should sign up for a different PayPal account for each.
Note: whenever a customer initiates a Apple Pay / Google Pay transaction they will not be shown upsells.
Overview
PayPal is an industry leader in payment processing services. PayPal can be implemented as a supplemental payment processing service as well as an all-in-one payment processing service that combines the PayPal-to-PayPal payment processing along with direct credit card processing (where the customer in the UltraCart checkout without any redirect to the PayPal website for login.
Business PayPal Account
You'll need a business PayPal account. To upgrade your current PayPal Personal Account to a Business or PremierAccount: Go to https://www.paypal.com/UPGRADE and log in to your PayPal account. Click the Upgrade Now button at the bottom of the page. The next page will allow you to choose a personal Premier Account or a Business Account.
Navigation
Main Menu → Configuration → Checkout → Payments → PayPal (section)
The following shows the Payments screen. Connect PayPal by clicking the blue Connect button.
The next screen will prompt you to connect UltraCart to your PayPal account. Enter in your PayPal email address and country, then click Continue as shown below.
Now you will be prompted to login to your PayPal account.
Click Agree and Connect to allow PayPal to connect to your UltraCart account.
Next you want to select “Use existing business account” and click Next
Below you can click on “Ill do this later” as you do not have to select anything here to complete the setup.
Here you need to make sure and click “Add Info” before clicking the “Go back to UltraCart” button.
Testing Your PayPal Integration
Testing Integration
To test your PayPal integration, you'll need to place a real order using either a personal paypal account (separate of your business paypal account) or for the Payments Pro integration, a real credit card (not configured as a test CC in the ultracart backend) then once you see a successful authorization occur for the payment, you can perform a refund to back out the charge associated with your test purchase.
Affiliate Management MassPay API Errors
PayPal MassPay Errors related to processing affiliate commissions via PayPal MassPay
While attempting to process payments for affiliates, an error appears on the page that says "PayPal MassPay API failed. You do not have permissions to make this API Call". This error means that you need to grant access to that particular API call within your PayPal account so that UltraCart can call it. Log into your PayPal account, then navigate:
PayPal Navigation
My Account → Profile → My Settings → My Selling Tools → API Access [update].
Under that section within PayPal.com, you'll need to give the UltraCart API login the additional permission to do MassPay, then save the changes.
Frequently Asked Questions
Q: After upgrading to the new API, I am not seeing Venmo payment button appear with the rest of the PayPal Payment buttons, why is that?
A: Venmo has to come later in the checkout in the ‘Options’ page. It appears in the options page because Venmo requires that all the address information be collected by the checkout, before the payment is initiated.
Q: I am seeing the ‘PayPal’ and ‘Pay Later’ stacked in the shopping cart page, why is that?
A: Those buttons appear stacked, because they are a single widget element that is injected into the checkout by PayPal.
Q: We are seeing OrderID’s for some transactions in PayPal that have letters at the end of the orderID, what is causing this to happen?
A: We have to make the order id unique in PayPal. The transaction process for orders that contain an accepted upsell after offer, is that we void the first transaction when someone takes an upsell that causes a change to the order total for the final PayPal charge. So, this change to the orderID would indicate a voided authorization, that is replaced by another transaction.
Q: I received a email notification from UltraCart regarding a ‘Payment Transaction Time-out on PayPal’ but the message does not provide specific details such as that?
A: Those buttons appear stacked, because they are a single widget element that is injected into the checkout by PayPal.