PayPal Standard

Easy Digital Downloads comes with PayPal Standard built in. PayPal Standard is the most basic PayPal account you can get. 

NOTE: A free PayPal Business account is required to connect to EDD. You can either upgrade an existing PayPal Personal to a Business account or create a new PayPal Standard Business account.

Settings

Settings are found under  Downloads → Settings → Payment Gateways → PayPal Standard.

1. PayPal Email Address

The first setting is your PayPal email address. This is the address associated with your PayPal account.

2. PayPal Image (Optional) 

Next you have the option of uploading an image to display on the PayPal checkout page.

TIP: The image must be publicly accessible on the internet and stored on a secure (HTTPS) server for it to show on the PayPal checkout. Logos should be a maximum of 90 pixels wide by 60 pixels high and saved as a valid graphics format, such as .gif, .jpg, or .png.

NOTE: This was previously called PayPal Page Styles, but the page style options were deprecated by PayPal in favor of supplying an image.

3. PayPal Identity Token

Next, enter your PayPal Identity Token. This is required in order for payment records to be automatically marked as Complete immediately after purchase.

This token can be obtained from your PayPal account by following these steps:

  1. Log in to your PayPal account.
  2. Hover over the cog in the upper right corner of the screen and select Account Settings
  3. Under the Products & Services heading, click on Website payments on the left side of the screen
  4. Click the Update link next to Website Preferences
  5. Set Auto Return to On
  6. For the return URL, enter your website URL.
  7. In Payment Data Transfer, click the On option.
  8. Click Save.
  9. Repeat steps 2 and 3.
  10. To view your PDT identity token, scroll down to the Payment Data Transfer section on the page.

Copy the token to your clipboard and paste it into the PayPal Identity Token field in Downloads → Settings → Payment Gateways → PayPal Standard.

4. IPN Settings

The PayPal Instant Payment Notification (IPN) service  allows PayPal to communicate with your store, and mark transactions as complete, failed, refunded, etc. 

The PayPal IPN will be configured automatically when using PayPal Standard but it is still important you can confirm it is enabled inside your PayPal account.

Log into your PayPal account and hover over the cog in the upper right corner of the screen, then select Account Settings.

Click Notifications on the left side of the screen, then click Update next to Instant Payment Notifications.

Click the Edit Settings button, then enter your domain (including http or https) followed by ?edd-listener=IPN

Choose the radio button for Receive IPN messages (Enabled).

If the PayPal IPN is not working, you can disable IPN verification, which simply disables an extra verification step that is performed when IPN messages are processed.

NOTE: PayPal IPN verification requires an SSL certificate. See our PayPal SSL FAQ for more information.

If you need to access your PayPal IPN history, see  this guide.

5. API Keys

PayPal API keys allow your store and PayPal to communicate more fully, allowing for more reliable communication as well as some additional features like  in-store refunds. This section needs API keys for Live and Test for: 

  • Username
  • Password
  • Signature

Full documentation on getting PayPal API keys is found here.

FAQ

What is the difference between PDT and IPN, and do I need both?

PDT (Paypal Identity Token) and IPN (Instant Payment Notification) are both ways that Paypal uses to tell your store that a Payment was successful, so that the status can be set to "complete", releasing the files to the customer.

PDT is an alternative to IPN. You should use both to get the most accuracy from Paypal. You especially need to make sure that IPN is set up if you are using Recurring Payments. 

My store's Paypal payments remain as "Pending" and are not being set to "Complete". What should I do?

This can happen for a number of different reasons. We have a list of possible solutions to help get this working properly here:  https://docs.easydigitaldownloads.com/article/190-payments-not-marked-as-complete