Creating Sandbox test accounts
Sandbox test accounts are virtual PayPal accounts that exist only in the Sandbox environment. These accounts represent the user entities that partake in the mock transactions you create as you run your application in the test phase. Create at least one test account for each user represented in the transactions you generate with the PayPal APIs.
The Sandbox supports two different test account types:
- Personal, represents the buyer, or sender, in a transaction.
- Business, represents the merchant, or receiver, in a transaction.
Important: To test a typical PayPal transaction, you need both a Business test account and a Personal test account. When you register as a PayPal developer, the Sandbox automatically creates for you a Business test account (such as
email@example.com) and its associated Classic API test credentials. However, to make test calls in the Sandbox, you must also create a Personal account to act as the buyer in your mock transactions.
Tip: If you have an existing set of Sandbox test accounts, see Importing Sandbox accounts from an existing Developer Central account.
Creating a Personal test account
Create a Personal test account to represent the buyer in a transaction.
When you create a new test account, you assign to it email address and password values that you create. You use the email address to reference the test account in your test API calls. You’ll also use the email and password values to log in to the Sandbox test site to view and configure the test account.
Tip: To simplify the testing process, consider using the same password for all of your Sandbox test accounts.
Create a Sandbox test account
- Log in to the Developer site at https://developer.paypal.com and navigate to Applications > Sandbox Accounts.
- Click the Create Account button and populate the following fields:
Account type Tick 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 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 alpha-numeric characters in length. First and Last names The optional name fields accept alpha-numeric 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 5000. 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.
(Personal accounts only.)
Credit card type You must select a single credit card type for each test account. The Sandbox associates a mock credit card number with the account. Log in with PayPal Tick the I want to add Log in with PayPal to my site box and complete the following fields to enable Log In with PayPal testing:
- Display name
- Return URL
- User agreement URL
(Business accounts only.)
Notes Add details specific to this test account.
- Click Create Account after completing the account details.
The new test account is listed with your other test accounts on the Accounts page.
Creating a Business test account
The Sandbox automatically creates your first Business test account when you sign-up for a Developer account on developer.paypal.com. PayPal generates the test Business account name by appending
-facilitator to your email name, and the account is assigned a set of Classic test API credentials that you can use to create mock PayPal transactions in the Sandbox.
To test Classic API calls, use test Business account values along with values from a Personal test account that you create (as described in Creating a Personal test account).
Some PayPal calls involve more than a single buyer and seller pair. In the testing phase, you need to create all the test accounts needed to fulfill the user entities that partake in your PayPal transactions. For example, parallel payment calls and Adaptive calls each require two different Business accounts, but for different reasons. In these cases, you need to create additional Business test accounts to play the roles of the entities in your transactions.
For more information on the different test account roles, see Planning your Test Accounts.