Express Checkout with Payflow Gateway - Testing
To test your integration, PayPal provides a sandbox testing environment to verify that your integration is working properly before releasing it to your buyers. The sandbox environment is a duplicate of the live PayPal environment, except no money changes hands.
Create sandbox accounts
You must create the following sandbox accounts:
- PayPal Manager test account for Payflow Gateway
- PayPal Developer account
- PayPal sandbox seller and buyer accounts
Important: Once you have created these accounts, you must link your PayPal Manager test account to your seller sandbox account.
Create a PayPal Manager test account
To create a PayPal Manager test account:
- Go to https://registration.paypal.com/welcomePage.do.
- Click Continue.
- Fill out the rest of the form. Select this option: I do not have a Processor. Setup test account.
- Choose a unique and case sensitive merchant login, for example,
- On the next page, do not click Continue, which activates the account and bills you. Instead, click the blue button labeled Login to PayPal Manager, which creates a test account.
You can login to your gateway account on the PayPal Manager website.
Once you log into PayPal Manager, create an API user:
- Click Account Adminstration.
- Click Manage Users.
- Click Add User.
- Create a new user and under Assign privilege to User choose one of the predefined roles:
- API FULL TRANSACTIONS. Allows the API user to perform all transaction types including credits.
- API LIMITED TRANSACTIONS. Allows the API user to perform sale and authorization transactions only.
- Click Update to create the user. Use these new user credentials for your website, shopping cart, etc.
Note: For external applications, websites should use the
API LIMITED TRANSACTIONSuser only and for back-end applications use the
API FULL TRANSACTIONSuser.
With an API user set up, use the credentials to populate the following fields in your requests:
Note: Your login ID is case sensitive.
Create a PayPal Developer account
The PayPal Developer account allows merchants and developers to create, reset and delete sandbox accounts. Additionally, all emails generated by the sandbox are delivered to a special mailbox that is only accessible from the PayPal Developer portal. If you have a live PayPal account, you can sign in using those credentials. If not, create a new account and login. Use the Developer portal to manage all your PayPal development related work.
Create PayPal sandbox seller and buyer accounts
For testing PayPal Express Checkout, you will have to create at least two sandbox accounts on the developer portal, a seller account and a buyer account.
- Go to the developer portal and login with your developer account from the previous section.
- Under Sandbox, click Accounts, then click Create Account on the right hand side of the page.
- For a Seller Account, set the account type to Business. Enter a real or fake email address and a simple password that is easy to remember, such as,
- Click Create Account.
- To create a buyer account, follow the same steps used to create a seller account above. Set the account type to Personal instead of business and enter a high balance amount, such as,
Link the test Manager account with the seller sandbox account
When you've created your buyer and seller sandbox accounts, you're ready to link them to Payflow Pro Manager. Here's how:
- Log in to your PayPal Manager account.
- Enter your Partner, Merchant Login, User (if applicable) and Password, and click Log In.
- Select Service Settings > Set Up.
- Under PayPal Express Checkout you'll see PayPal sandbox email address. Enter your PayPal sandbox Seller email address and scroll to the bottom of the page and click Save.
Payflow Manager has now been synced with your PayPal sandbox account and is ready to begin accepting sandbox test transactions.
Note: If you don't see the PayPal Express Checkout section on the Set Up page, contact PayPal Customer Service by phone at 1-888-883-9770 or email at email@example.com, ask that Express Checkout be added to your Payflow account for testing purposes, and provide your PayPal sandbox email address and your Payflow Merchant login information.
Credit cards for testing in the sandbox
In your buyer or personal sandbox account, you can enter generated test credit card numbers for use in your test transactions. You can use credit card numbers generated from the PayPal Developer Credit Card Generator.
In the expiry date field,
ExpDate, enter any date in future in the format
mmyy, such as,
1220. In the card security code field,
Cvv2, enter a number such as,
Handle errors (optional)
In some cases, if the transaction does not go through due to buyer funding issues that the buyer can correct, you can notify the buyer of the issue.
Implementing 10486 error redirect
If you get an error on the final
DoExpressCheckoutPayment API call with the code
10486, it is because of lack of funds in the funding source selected by the buyer. In such a scenario you should redirect the buyer back to PayPal. See How to recover from funding failure error code 10486 in Express Checkout.
- Express Checkout best practices — PayPal User Interface Standards help increase your conversion with your customers when they use PayPal Express Checkout and can help you optimize the customer experience for your integration.
- PayPal images and logos — PayPal buttons reference page.
- Express Checkout for Payflow Gateway reference guide.
- Payflow developer guide.