Recurring Payments - PayPal Express Gateway Configuration
Table of Contents
Recurring Payments integrates fully with PayPal Express. PayPal Express is available for Easy Digital Downloads via the PayPal Pro/Express extension. Full documentation for installing, configuring, and using that extension are here.
Before the PayPal Express Gateway will work you must enter API keys on the Gateways settings page. To find your keys in PayPal, click on your account in PayPal and click on Profile:
This will open a popup window. Click on the API Credentials tab. You'll see two API keys for Live and two for Test. Copy those credentials to Downloads > Settings > Payment Gateways in your Easy Digital Downloads admin panel.
See this guide for a more information about obtaining API keys.
Multiple Subscription Support
Instant Payment Notifications (IPN)
PayPal's Instant Payment Notifications (IPN) are how PayPal can communicate with your site to do things like confirm complete sales, failed sales, etc. For recurring billing to work properly with PayPal Express it's very important that your IPN settings are working properly.
Configuring your PayPal IPN is simple. First, log into your PayPal account and go to Profile → My Selling Tools → Instant Payment Notifications.
After you click Update you'll be presented with a page of information and a link to Choose IPN Settings.
You need to enable IPN messages and then set the Notification URL to: http://yoursite.com/?edd-listener=eppe
Important! Subscription tracking will fail if IPN is not configured properly.
Cancelling subscriptions is done in a variety of ways depending on your site setup and situation.
Cancelling as a Customer
- First log into PayPal.
- Then click on My money.
- Then find My preapproved payments and click Update
- Then click on the name of the Vendor you want to unsubscribe from and an Unsubscribe button will appear.
Cancelling as a Site Administrator
There are two ways to cancel PayPal subscriptions if you are a Merchant.
The page for managing subscriptions in PayPal is here: https://www.paypal.com/?cmd=_merchant-hub
Simply click a customer name and an Unsubscribe button will appear.
Within Easy Digital Downloads
Once PayPal Pro/Express is configured properly you will see a Cancel Subscription button on subscription pages within Easy Digital Downloads.
If you notice a customer that has a "Pending" or "Failed" payment from attempting to purchase a recurring product using Paypal Express In-Context, it could be that they navigated to a new tab while the pop-up was loading. The customer must not navigate to a new browser tab while the payment is loading. Unfortunately, this is a limitation in the way Paypal Express In-Context works.