Give supports PayPal’s Website Payments Pro integration via their Name-Value-Pair (NVP) API and supports accepting single-time credit card donations. If you would like to accept recurring donations your PayPal account will need Direct Payment Recurring Payments “DPRP” support. For new PayPal accounts, we recommend using the PayPal Payments Pro integration. The following documentation will guide you through integrating Give with PayPal Website Payments Pro.

Getting Started

In order to accept payments with PayPal Website Payments Pro using Give you will need to have an active PayPal account, the PayPal Pro Give Add-on, and the Give Core plugin installed and activated. As well, when accepting credit card donations on the site it is required that you have an SSL certificate for security.

Click here for instructions on installing and activating Give Add-ons.

Note: You can always access your add-on purchase receipts, downloads, and licenses from your Give Account dashboard.

Integrating with PayPal Website Payments Pro

Once you have activated the Add-on it’s time to request your PayPal API keys and to configure Give to integrate with those keys.

addon-paypal-pro-dashboard
PayPal Pro Dashboard

In order to accept credit cards directly on your website safely you will need an SSL certificate.

Obtaining your LIVE PayPal API Credentials

After logging into PayPal with your PayPal Pro account, you’ll see your PayPal Dashboard. Note: PayPal has a “new” interface and a “Classic” interface. They work similar, but they look different and some links may be in different page locations. For this article, we’ll be using examples from the new interface.

To obtain your PayPal API Credentials:

  1. First click on Profile. You’ll find that on the far right with the My Account tab active.
  2. On that screen, look under the My Selling Tools section
  3. Click on the the link called API Access.
PayPal API Access (New interface)
PayPal API Access (New interface)

4. Next click on View API Signature under “NVP/SOAP” API Integration

paypal-nvp-credentials

Finally, copy the following keys to a place where you can easily add them to Give’s settings:

PayPal API Credentials
PayPal API Credentials

I usually open a blank notepad doc and paste my API keys in there for easy access later.

Inserting the PayPal API Keys into Give

PayPal Pro API Settings
PayPal Pro API Settings

Now that you have the keys, go to your WordPress admin Dashboard, and click on “Donations > Settings” then click on the Payment Gateways tab.

From there, scroll down until you see the section called PayPal Website Payments Pro API Keys and paste each key into its respective field, then hit save.

That is all that is needed to integrate your PayPal Pro account with Give. Now when your donors go to donate, they will see credit card fields available to donate with.

Test with the PayPal Sandbox

The PayPal Sandbox is helpful for ensuring your donation forms are working as expected without having to use real money. Note: The PayPal Sandbox can often be often unreliable, buggy, and slow. As well, the interface uses the “Classic” mode and there are differences between LIVE and Sandbox PayPal like response times and setup. Despite this, as best practice you can and should test as your setup with the Sandbox prior to going live with any donation forms.

Place Give into Test mode

Your first step is to put Give into “Test Mode“. Read about that here before moving on.

Obtaining Sandbox API Credentials

Once Give is in Test mode, you’ll need to setup your PayPal sandbox account. After that account is setup, log into that sandbox account to obtain the API credentials for the sandbox account.

  1. Click on the My Account tab and then click Profile
  2. Next you’ll be presented with the Request API credentials screen and you’ll see two options. Choose Option 1: PayPal API and click on #2 Set up PayPal API credentials and permissions.
Request Sandbox API Credentials
Request Sandbox API Credentials

The next screen will also give you two options. Choose Option 2 by clicking on View API Signature.

This screen holds all the keys that you need to test Give with your PayPal account.