How do I create a PayPal sandbox account?

The PayPal Sandbox allows you to set up test accounts that can be used to test the full purchase process in Easy Digital Downloads with the PayPal gateways.  No charges actually take place, and you may use it for as long as you like.

How do I set up the account in PayPal?

To create a sandbox account, visit http://developer.paypal.com and click Login or Signup if you do not already have an account set up. You can log in with your existing PayPal account.

Once logged in, click on Dashboard in the top menu:

Dashboard will take you to a screen that looks like this:

Now click on the Accounts link under the Sandbox menu, which will take you to this page:

Click on the blue Create Account button in the top right corner of the screen. You will now be presented with an account creation form:

Select your country and choose Business for the account type. All other fields can be filled out however you wish.

Once the account is created, it will be shown in the Accounts list under the Sandbox menu.

How Do I Use This Account?

Click on the account and click on Profile:

This will open a popup window. Click on the API Credentials tab.  You'll see two API keys for Test. Copy those credentials to Downloads > Settings > Payment Gateways in your Easy Digital Downloads admin panel.

Important:

When using PayPal Standard (the gateway provided in EDD core), the API keys can be used for refunds if you are using version 2.6+. 

The API keys are used for:

  • PayPal Standard
  • PayPal Express
  • PayPal Pro
  • PayPal Adaptive Payments 

Also important:

Both the Test Vendor and the Test Buyer must use an email account from the Paypal Sandbox. Otherwise the test will fail.

How Can I Be Sure I'm In Testing Mode?

To make sure your site is operating in Test Mode, go to Downloads > Settings > General and make sure the Test Mode box is checked.

Remember

Before you go live with your site, take it out of Test Mode or none of your sales will be valid.