Set Up Account and Environment
Last updated: Feb 7th, 10:24am
Important: PayPal Provisioning Platform is a limited-release solution available only to select partners at this time. For more information, reach out to your PayPal Account Manager.
Take these steps before beginning your P3 integration:
Get PayPal REST API credentials
To generate REST API credentials for the sandbox and live environments:
- with your PayPal account.
- Under the DASHBOARD menu, select My Apps & Credentials.
- Make sure you're on the Sandbox tab to get the API credentials you'll use while you're developing code. After you test and before you go live, switch to the Live tab to get live credentials.
- Under the App Name column, select Default Application, which PayPal creates with a new Developer Dashboard account. Select Create App if you don't see the default app.
Make sure you complete these steps to get credentials for both sandbox and live apps.
Note: To prevent lockout, create an email distribution list with a corporate address for the Sandbox and Live environments. For each environment, follow these best practices:
- Use a different email address.
- Create a business account and a customer account.
Submit your client ID for provisioning
Contact your account manager or Global Professional Services to enable the PayPal Provisioning Platform for your client ID. Your client ID is generated when you get PayPal REST API credentials.
PayPal must provision your client ID before you can make API calls. Submit your sandbox client ID for provisioning while your team reviews the technical documentation. Once you have started performing integration testing in sandbox, submit your live client ID for provisioning.
Create sandbox accounts
To test your web and mobile apps with mock transactions, create a personal account to represent the buyer and a business account to represent the merchant.
- Log into Dashboard and type your PayPal business account email and password. If you do not have a business account, click Sign Up.
- Under Sandbox, click Accounts and click Create Account.
- To create the buyer account, select the personal account type and click Create Account. A personal account with default values for balances and other information is created for you.
- To create the merchant account, select the business account type, type account information, and click Create Account.
Meet security requirements
Information and network security
Your integration must meet these information and network security requirements:
- Information security— Your environment must support TLS 1.2 with mutual authentication and HTTP/1.1.
- Network connectivity— PayPal recommends connecting over the open Internet for these APIs.
Log IDs
To assist PayPal support with debugging any issues encountered during the integration, be sure to log the PayPal-debug-ID
and the referral ID
values that are returned with these responses.
Value | Description |
---|---|
PayPal-debug-ID |
Response header Value that identifies this request used by support. |
referral ID |
Returned in the Consumer Referral API Response PayPal-generated ID sent to the client in the Consumer Referral API response. The client can send this ID in subsequent API calls and use this ID to determine whether API calls are for the same user’s provisioning flow. A front-end URL parameter also passes this same identifier to PayPal. |
Next
Integration Steps: Choose Integration Flow