Introduction

This tutorial will walk you through the process of upgrading your PayPal integration to their latest offering.

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

• Better handling of upsell after offers

Restrictions

• Similar to Apple Pay / Google Pay, whenever a customer initiates a PayPal / Venmo transaction they will not be shown upsells.

Pre-Requisites

This tutorial assumes that you already have:

1. UltraCart account connected to PayPal

2. Using a StoreFront Visual Builder based theme for your checkout. We recommend making sure your theme is updated to the latest available version.
   Supported themes are:

   1. Elements - 2.13+

   2. Hero - 1.17+

   3. Jewel - 1.13+

   4. Lifty - 1.15+

   5. Native - 1.12+

   6. Natural VB - 1.12+

   7. Poppy - 1.03+

Payment Configuration

Navigate to Configuration → Checkout → Payments. The payment configuration screen should look like the screenshot shown below. Click on the Upgrade button to begin the connection process.

...

Next you want to select “Use existing business account” and click Next

...

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: 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.

Related Documentation

PayPal API Transaction Responses: https://developer.paypal.com/api/nvp-soap/errors/