Gravity Forms and PayPal make collecting payments simple and easy. With the PayPal Add-On you can do more than just collect data, you can quickly integrate any form with your PayPal account to create powerful order forms. If you are familiar with the MailChimp, Campaign Monitor and FreshBooks Add-Ons you should have no problems getting started with the PayPal Add-On.
The Gravity Forms PayPal Add-On requires the use of the Pricing Fields in Gravity Forms v1.5+ and will not work with older versions of Gravity Forms. The PayPal Add-On requires a valid Gravity Forms Developer License to receive access to automatic upgrades and documentation. Installing the PayPal Add-On
- Download the add-on plugin from the Add-Ons download page.
- Upload the plugin folder and files via FTP to your wp-content/plugins folder OR upload the plugin zip file via the “Add New” plugin menu in WordPress.
- Activate the “Gravity Forms PayPal Add-On” plugin you just uploaded.
Setup The PayPal Add-On
Now that the PayPal Add-On is installed and active you will need to setup your site to integrate with PayPal. Gravity Forms requires IPN to be enabled on your PayPal account. The settings page provides you with instructions on how to do so.
- Navigate to your PayPal IPN Settings page.
- If IPN is already enabled, you will see your current IPN settings along with a button to turn off IPN. If that is the case, just check the confirmation box on the Gravity Forms PayPal settings page and you are ready to go!
- If IPN is not enabled, click the ‘Choose IPN Settings’ button.
- Check the box to enable IPN and enter the following Notification URL: http://www.yourdomain.com/?page=gf_paypal_ipn
Once you have setup IPN by following the on screen directions you must then confirm that you have done so by checking the confirmation box on the Gravity Forms PayPal settings page.
Advanced Note: If your IPN is already active and you have another Notification URL populated here, you do not need to populate the Gravity Form IPN Notification URL. Gravity Form/PayPal only requires that the IPN is enabled and that any Notification URL is populated in your PayPal settings. The Gravity Form IPN Notification URL is sent as the 'return_url' parameter for every PayPal Add-on transaction.
Setup PayPal Feeds
Your PayPal Feeds allow you to integrate a form with your PayPal account to accept online payments and receive real time feedback via PayPal IPN. This allows you to automatically pass data from your form to PayPal to receive payment, and in return PayPal will communicate back to Gravity Forms with verification that payment has been received.
- Click on the PayPal navigation item on the Forms menu.
- Click on the “Add New” button to add a new PayPal Feed.
- Enter your PayPal Email Address
- Select the PayPal mode. The available options are Production and Test. For development purposes you can use the Test mode, however you must sign up for an account to use PayPal’s Sandbox Test Environment. Sign up here. You must be logged in to the PayPal Sandbox to use Test mode.
- Select a Transaction Type. Available options are Products and Services for standard transactions, Donations and Subscriptions for recurring payments.
- Select the Gravity Form you would like to integrate with.
- If you have chosen a Subscription as your Transaction Type you will be given options for the Recurring Amount, Billing Cycle, Recurring Times and Trial Period. These are used to setup the recurring payment.
- Map the PayPal Fields to your available Form Fields. This tells Gravity Forms which form fields should pre-populate the available PayPal fields. This is optional.
- Enter a custom Page Style name if you are using custom PayPal Page Style’s. This is optional.
- Customize the PayPal Continue Button text by entering text in the Continue Button Label field. This is optional.
- Enter a custom Cancel URL that will be used if the customer cancels the transaction before completing it. This is optional.
- Select available PayPal options. Options allow you to determine when notifications are sent and if posts and/or users are created before or after payment is received.
- Save Feed
PayPal Subscription Cancellations
When setting up PayPal Subscriptions please keep in mind that in order for a user to cancel a subscription they must do so from their PayPal account or you will have to manually cancel their recurring subscription from within your PayPal account. There is no cancellation functionality built into the PayPal Add-On.
When a PayPal Subscription is canceled within PayPal it will communicate back to your site via PayPal IPN and update the entry data with the canceled subscription status.
The User Registration provides an assortment of hooks that can be used to modify the default functionality or extend it. For more information visit the PayPal Add-on Developer Docs page.