Sandbox accounts

You can create sandbox accounts in the PayPal Sandbox environment. Use sandbox accounts to generate mock transactions to test your app.

The PayPal Sandbox supports:

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

To test a typical PayPal transaction, you must create 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 Test Accounts page.

Note: You can link sandbox accounts 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 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 sandbox accounts page to view and configure the sandbox 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 test NVP/SOAP API calls, use Business sandbox account values along with the personal sandbox account values.

Manage sandbox accounts

  1. On the Developer site, click Dashboard.

  2. Navigate to Sandbox > Accounts.

  3. Log in to Sandbox sandbox accounts.

  4. On the Dashboard tab, you can:

  5. Log in to the PayPal Developer site, click the Dashboard tab and navigate to Sandbox > Accounts.

  6. Click the expand icon associated with the account you want to manage to view the Profile link.

The Accounts details dialog displays, which lets you view and configure various account settings.

  1. Click the expand icon for an account.

    The Profile and Notifications links appear.

  2. Click Profile.

  3. On the Profile tab on the Account Details dialog box, click Change password.

  4. Enter a new password and click Save.

You can change the password of a test account from the Profile tab of the Account details dialog.

To link sandbox accounts to your developer account:

  1. Click Log in to PayPal and and provide your sandbox account credentials.

  2. After you log in successfully, a success message appears and your sandbox account appears on the Developer site.

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

  3. Tick the box in the left column of the account(s) you want to delete.

  4. Click the Delete button.

Note: You cannot delete the default sandbox accounts that the PayPal Sandbox creates.

  1. Select one or more accounts.

To link pre-existing test accounts on the Sandbox test site to your Developer site account, do the following:

A message confirms the successful deletion of the accounts.