Back to Platform Selection

Gravity Forms

PayPal Upgrade Guide

This document guides you on the process of moving to the recommended PayPal Checkout extension. This is a newer, free extension that has the same and more features than older extensions.

Requirements & Installation

The Gravity Forms PayPal Checkout Add-On, when connected to the PayPal Checkout, allows you to quickly and easily accept payments from 286 million PayPal customers, in over 100 currencies and across 200 markets, with advanced Fraud Protection and unprecedented control.

(This add-on was previously named PayPal Commerce Platform at version 1.0. Note that the filters do still use the _ppcp_ naming convention, and have not been changed to avoid any issues with existing hook users.)

  • Your PayPal account country and account type must be listed as supported for onboarding before payment in the following PayPal’s documentation page. If PayPal doesn’t support onboarding before payment for your account, you can’t use this add-on.
  • You will need Gravity Forms version 2.4 or greater and the Gravity Forms PayPal Checkout Add-On installed and activated.
  • Because of the secure nature of capturing payment information, you will be required to install an SSL certificate on your web site if you have not already done so. You will also need to configure your WordPress site to work properly with SSL.
    • Contact your web host if you need assistance purchasing and configuring an SSL certificate. And configure your site WordPress Address and Site Address to use the https prefix once your certificate is ready.


Getting Started

Access your website dashboard that has your existing Gravity Forms plugin with the older PayPal payment option by logging in to your WordPress Admin Dashboard (Default is /wp-admin but yours could be different if you changed it).

  • On the far-left menu hover over Forms, and click on Settings
  • Keep the WordPress Admin Dashboard open in the new tab side-by-side with this upgrade guide to easily follow along with each upgrade step.


Get Help from PayPal

Contact a Payments Specialist who can guide you through the upgrade process or call us at (888) 429-3035.


Visual Upgrade Guide

Step 1

Once logged in to the Gravity Forms dashboard, hover over "Forms," and click on "Settings."

screenshot-1
Step 2

On Gravity Forms, click on "PayPal Checkout" tab and then click on "Connect with PayPal."

screenshot-2
Step 3

In the PayPal modal which is displayed, follow the steps provided by PayPal to connect to an existing PayPal account or create a new PayPal account. When you have completed connecting the add-on to your PayPal account, click the "Go back to Gravity Forms" button to close the modal. The add-on settings page will reload.

screenshot-3
Step 4

When the add-on is successfully connected, the "Connect with PayPal" button will be replaced with your PayPal merchant ID and the "Disconnect from PayPal" button.

screenshot-4
Step 5

Click "Add New"

screenshot-5
Step 6

Add fields for capturing customer billing and/or delivery information. We included the Name, Address and Email fields to get basic information from customers; however, you can use other field types (such as Single Line Text fields) to collect this information if you prefer.

screenshot-6
Step 7

Add "Pricing" fields to your form and configure them as needed. In this example "Product", "Shipping", and "Total" fields serve as the Pricing fields.

screenshot-7
Step 8

Add the PayPal Field – Expand the Pricing Fields section and add the PayPal Field to your form. When using multiple add-ons, such as the Stripe Card field, conditional logic should be used to show/hide the field depending on the payment processor selected in another field such a Drop Down field. Note: The PayPal Field is not compatible with the Gravity Forms Credit Card field.

screenshot-8
Note

If your form does not look exactly like the images above, don’t panic. Every form will vary depending on which fields were selected and what order they were added to the form. As long as you have pricing fields of some sort and the PayPal Field, your form is valid for integration.

Configuring a Feed

The feed configuration determines what type of transaction should occur when the form is submitted, what to use as the payment amount, and which fields contain values that should be passed to PayPal. If you have have added a "PayPal Field" to your form, you should find that a feed has already been created and configured automatically for you in the "Form Settings" > "PayPal Checkout" area. You’ll want to view this feed to ensure the "Billing Information" fields are mapped to the correct form fields.

Step 9

To configure a PayPal Checkout Feed, go to your Admin Dashboard and click on "Forms" in the left side menu. Select the form that you want to use with PayPal Checkout. Once within your desired form, hover over "Settings" and click on PayPal Checkout".

screenshot-11
Step 10

Click "Add New" to create a new feed or click the "Edit" action link which appears when you hover over an existing feed in the table. You will then be presented with the PayPal Checkout feed settings screen.

screenshot-12
Step 11

Feed Setting - A feed "Name" is required. It is only used for identification and will not be shown anywhere other than your feed listing. You also need to select the "Transaction Type". This drop down contains the transaction types which the add-on supports. "Products and Services" or "Subscriptions" (recurring payments).

screenshot-13
Step 12

If you select "Products and Services" from the "Transaction Type" drop down, the options below will appear.

Payment Amount

This drop down allows you to select what should be used as the payment amount. A specific product field within your form or the form total.

screenshot-15
Other Settings - Billing Information

Configures what billing information is sent to PayPal when processing a transaction. Map each of the billing fields to the desired form field that will contain that information.

screenshot-16
Other Settings - Options

If you do not need PayPal to capture a shipping address, enable the checkbox labeled "Do not prompt buyer to include a shipping address".

screenshot-17
Other Settings - Conditional Logic

If unchecked, every successful form submission will be sent to PayPal. If you want payment to be conditional based on how the user completes the form, check the “Enable Condition” box and fill out the rules which must be met.

screenshot-18
Subscriptions

If you select Subscriptions from the Transaction Type drop down, there are some other options available to configure, please check the Configuring Subscriptions in PayPal Checkout documentation for more details. (https://docs.gravityforms.com/configure-paypal-checkout-subscriptions/)

© PayPal 1999–2024

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more