Sandbox accounts

Use sandbox accounts to generate mock transactions to test your app. The PayPal sandbox supports these account types:

Account type Represents
Personal The buyer in a transaction
Business The merchant in a transaction

To test a typical PayPal transaction, you must use both types of accounts.

When you register as a PayPal developer on the developer site, the PayPal sandbox creates these sandbox accounts:

  • A business account and associated NVP/SOAP API test credentials. For example, pp.merch01-facilitator@example.com.

  • A default personal account. For example, pp.merch01-buyer@example.com.

You can create additional sandbox accounts on the developer site or directly on the sandbox site, https://www.sandbox.paypal.com.

Note: You can link a sandbox account to your developer account.

Some PayPal transactions require more than one buyer-and-seller pair. For example, parallel payment calls and Adaptive calls each require two different business accounts but for different reasons. In these cases, you must create additional sandbox business accounts to play the roles of the entities in your transactions.

For information about sandbox account roles, see plan your sandbox accounts.

Create and manage sandbox accounts

On the developer site, you can:

Create a personal sandbox account

Create a personal sandbox account to represent the buyer in a transaction. The PayPal sandbox automatically creates your first personal sandbox account when you sign up for a developer account on the developer site. To generate the personal sandbox account name, PayPal appends -buyer to your email address.

When you create a sandbox account, you assign an email address and password to it. You use the email address to reference the sandbox account in your test API calls. You also use the email and password values to log in to the sandbox accounts page to view and configure the sandbox account.

To create an additional personal sandbox account:

  1. Log in to the developer site sandbox accounts page.
  2. Click Create Account.
  3. Set the Account Type to Personal.
  4. Enter an email address. This address can be a fake email address.
  5. Enter the account password.
  6. Under Payment Methods, enter the test buyer's PayPal account balance.
  7. To test credit card transactions, enter a test credit card number.
  8. Click Create Account.

Tip: To simplify the testing process, use the same password for all your sandbox accounts.

Create a business sandbox account

The PayPal sandbox automatically creates your first business sandbox account when you sign up for a developer account on the developer site. To generate the account name, PayPal appends -facilitator to your email name. PayPal assigns a set of NVP/SOAP test API credentials to the account. Use the account to create mock PayPal transactions in the PayPal sandbox.

To create an additional business sandbox account:

  1. Log in to the developer site sandbox accounts page.
  2. Click Create Account.
  3. Set the Account Type to Business.
  4. Enter an email address. This can be a fake email address.
  5. Enter an account password.
  6. Under Payment Methods, enter the test merchant's PayPal account balance.
  7. Click Create Account.

Tip: To simplify the testing process, use the same password for all your sandbox accounts.

Manage sandbox accounts

On the developer site sandbox accounts page, you can:

Change a sandbox account password

To change the account password:

  1. Log in to the developer site sandbox accounts page.
  2. Click the expand icon associated with the account you want to manage. The Profile and Notifications links appear.
  3. Click Profile.
  4. On the Profile tab of the Account Details dialog box, click Change password.
  5. Enter a new password and click the Save link, located just below the password text box.

Delete a sandbox account

To delete an account:

  1. Log in to the developer site sandbox accounts page.
  2. Tick the box in the left column of the account(s) to delete.
  3. Click Delete. A message confirms the successful deletion of the account(s).

Note: You cannot delete the default -facilitator and -buyer sandbox accounts that the PayPal sandbox creates.

To link a pre-existing sandbox account to your developer account:

  1. Log in to the developer site sandbox accounts page.
  2. Click log in with PayPal. Then, enter your sandbox account credentials.
  3. A message confirms successful log in. Your sandbox account appears on the developer site.

Note: If your sandbox account is already linked to another developer account, you cannot link it to your developer account.