Configure Sandbox Accounts

To set up your PayPal Here implementation for testing in the PayPal sandbox:

  1. Set up a PayPal Developer site account.
  2. Create a REST application to get your sandbox credentials.
  3. Create a 'merchant' sandbox account to use in the onboarding and also act as the receiver of funds.

Create a PayPal account

To access PayPal Developer, create a business PayPal account that can be shared with others on your development team. Sign up with a team email address instead of an individual email to make sharing easier.

Note: A PayPal account, which you use to log in to the PayPal Developer site, is an actual Live/Production account and is different from the sandbox accounts that you'll create.

PayPal does a verification check by sending an email message to the email address you specified. Enable your account by responding to the PayPal verification message. If you don't receive the verification email within a few minutes after signing up, please check to see that it hasn't been blocked or diverted to a spam folder.

After you enable your PayPal developer account, you can log in to the PayPal Developer site with the username and password of your PayPal Developer account. You can use your PayPal Developer account to:

  • Create one or more PayPal REST apps, which come with the default sandbox and live client credentials.
  • Create and access additional Business and Personal Sandbox accounts for testing.

Create a REST application

After you create a PayPal developer account for your team, create a PayPal REST app on the PayPal developer site.

  1. Log into PayPal Developer with your team's PayPal account.
  2. Click Dashboard and then click Create App underneath the My Apps & Credentials section. When you create your REST app, PayPal assigns default Sandbox client credentials and Live client credentials to your app. You can view each of these by clicking the Sandbox or Live settings toggle in the top right of the app settings page.
  3. In both the Sandbox and Live app settings, you must enable the following in order to get access to the scopes you need to gain permission to act on the merchant's behalf:
    • Connect with PayPal. When you enable Connect with PayPal, click Advanced Options and select Personal Information and Address Information, which are disabled by default. The PayPal Here SDK needs this information to gather the necessary merchant account information.
    • PayPal Here

Note: For more information on how to register a REST application, see Manage Your Apps.

Create Sandbox Accounts

After you have created your PayPal REST app, you need an additional Sandbox Business account. To create a sandbox account:

  1. Log in to the PayPal Developer site with the username and password of your team's PayPal Developer account.

  2. Click the Dashboard and then, in the left-hand navigation, click Sandbox > Accounts.

    Note: When you create your PayPal Developer account, a merchant test account is automatically created for you with –facilitator inserted into your email address; for example, Instead of using this default account, create additional sandbox accounts.

  3. Click the Create Account button.

  4. Fill in the Create Test Account Form.

  5. Click Create Account.

Create test account form

Field Description and instructions
Country Select your country from the drop down menu. PayPal Here is available for US, UK, and AU accounts.
Account Type Select Business for a test merchant account.
Email Address An email address, which does not have to be a working email address, to reference this test account in your API calls and to log in to the PayPal Sandbox test site for reviewing account information. The Sandbox doesn't send email messages outside of the Sandbox environment.
Note: Email messages from the Sandbox environment to Sandbox accounts are displayed on the PayPal Developer site (Dashboard > Sandbox notifications).
Password The password must be 8-20 alphanumeric characters long. You can provide the same password for all Sandbox accounts. Use the password to log in to the PayPal Sandbox test site for reviewing account information.
First Name and Last Name The name fields accept alphanumeric characters.
Payment Methods
Paypal Balance Optional Test accounts with positive bank balances. Enter an integer value between 1 and 5000.
Bank Verified Account Create both PayPal verified and unverified test accounts so you can fully test your application.
Select Payment Card Test payments made with different payment cards.
Note: This field refers to payment cards that are linked to the sandbox account. This field has no connection to payment cards that you might use for testing your app.
Credit Cards Select a single credit card type for each test account. The Sandbox associates a mock credit card number with the account.
Note Add optional details specific to this test account.

After you click the Create Account button, the test account is added to your list of Dashboard > Sandbox > Accounts. You can log into the PayPal Sandbox with the username and password from your test account to review the status of the mock transactions associated with the account.

For more information, see the Managing your Sandbox accounts in the Sandbox guide.

Note: You can also create multiple accounts at a time using the Bulk Upload tool. See Uploading Sandbox accounts in bulk for details.


Test in the sandbox.