Create sandbox accounts

Learn how to create sandbox accounts.

Note: To simplify the creation of multiple accounts, do one of the following:

Create a sandbox account

To create a sandbox account:

  1. Log in to the Developer site at https://developer.paypal.com. On the Dashboard tab, navigate to Sandbox > Accounts.

  2. Click Create Account and populate the following fields:

    Country Select the country of the merchant or buyer test account.
    Account type Select either the Personal or Business radio button.
    Email address

    The email address doesn't need to be a real email address; the Sandbox doesn't send any email outside of the Sandbox environment. Email to Sandbox accounts, generated as a result of your test API requests, are listed on both the Notifications tab on the Developer site, as well as on the Sandbox test site.

    Use the assigned email value to reference this test account in your test API calls, and to log in to the Sandbox site when you want to review the details associated with the account.

    Password The password must be 8-20 alphanumeric characters in length. Use the password to log in to the Sandbox test site as the test account.
    First and Last names The optional name fields accept only alphabetical characters.
    PayPal balance While this field is optional, it's a good idea to create test accounts with positive bank balances. Enter an integer value between 1 and 10 Million.
    Bank Verified Account You should create both Verified and Unverified test accounts so you can fully test your application.
    Select Payment Card Test payments made with different payment cards by selecting either Discover or PayPal.
    (US Personal accounts only.)
    Credit card type Optionally, you can select a single credit card type for each test account. The Sandbox associates a mock credit card number with the account.
    Notes Add details specific to this test account.
  3. Click Create Account.

The sandbox account appears with your other sandbox accounts on the Accounts page.

Accept credit cards in test transactions

To use a credit card as a payment method in your test transactions, you must configure a test Business account as a Website Payments Pro account:

  1. Create a sandbox Business account or use an existing account.
  2. Return to the Sandbox > Accounts page and click the expand icon next to the email address of your newly created Business account; click on Profile to open the Account Details dialog.
  3. On the Profile tab of the Business account, click the Account type: Upgrade to Pro link.
  4. Click the Enable which appears in the window.

Tip: After you enable Website Payments Pro for a test Business account, the setting is permanent and you cannot undo the configuration for that account. We recommend you create multiple sandbox business accounts with various settings in order to test all the variations you might need to handle with your application.

Accept Easy Payments with PayPal Credit in test transactions

To use Easy Payments with PayPal Credit as a payment method in your test transactions, you must configure a test Business account as follows:

  1. Create a test Business account or use an existing account.
  2. Return to the Sandbox > Accounts page and click the expand icon next to the email address of your newly created Business account; click on Profile to open the Account Details dialog.
  3. On the Settings tab of the Business account, enable PayPal Credit by clicking the PayPal Credit > On toggle.

Duplicate a sandbox account

If you have an existing Business or Personal test account, you can easily clone that account to create a new account of the same type. This can be helpful if you're trying to model several merchants or customers that have slightly varying properties. By creating multiple test accounts, you can test various payment flows and error scenarios.

When you clone a sandbox account, PayPal automatically copies the account type (Business or Personal), PayPal balance, first name, and last name of the original account to the new account. PayPal creates an email address for the account by appending -1 to the original email address. If you clone the same account again, PayPal follows the same pattern and increments the ID. A second cloned account appends -2 to the email address.

After you clone an account, PayPal lets you edit the PayPal balance, first name, last name, and email address. You must also set a password for the new account, the password is not cloned.

To duplicate a sandbox account:

  1. Log in to the Developer site and navigate to the Sandbox Test Accounts page to view your existing test accounts (Dashboard > Sandbox Accounts).
  2. For each account you want to duplicate, press the clone icon button on the far right side of the test accounts table.
  3. Edit any fields you want to modify, supply payment information, and click OK to complete the process.

Note: When you duplicate a sandbox account, the Pro status is disabled by default and any flags that have been set up by your Account Manager are not duplicated to the new account.

Some test accounts have cloning disabled for the following reasons:

  • Test account is still in the creation process.
  • The test account partially or completely failed on the back-end during the creation process and such accounts cannot be cloned.