Configuring accounts

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

  1. Set up a PayPal Developer site account, as described in the next section.
  2. Create a REST app to get your client credentials.
  3. Create a merchant sandbox account to use in the onboarding and also act as the receiver of funds.

Creating 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.

Get sandbox credentials

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
  2. Click Dashboard and then click Create App underneath the My Apps & Credentials section.

See the Manage your applications page for more information on how to register a REST application.

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.

In both the sandbox and live app settings, you must enable:

  • Log In with PayPal. When you enable Log In 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

When you enable the previous settings, you get access to the scopes you need to gain permission to act on the merchant's behalf.

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 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, dev-facilitator@example.com. Instead of using this default account, create additional sandbox accounts.

  3. Click the Create Account button.

  4. Fill in the Create Test Account form as described in the following table.

  5. Click Create Account.

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

Field Description
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 does not send email messages outside of the sandbox environment.
Note: Email messages from the sandbox environment, to sandbox accounts, resulting from your testing of API requests, 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 and when logging in while testing a buyer's PayPal Here purchase experience.
First Name and Last Name The name fields accept alphanumeric characters.
Payment Methods
Paypal Balance While this field is optional, you should create test accounts with positive bank balances. Enter an integer value between 1 and 5000.
Bank Verified Account You should 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. For more information, see the Create and manage sandbox accounts section of the About sandbox accounts page. You also 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.

Now you can test using the account you just created. When you initiate the onboarding flow, this newly created business account is the one that you will login with to give permissions to your Partner account to process PayPal Here transactions.