Important: PayPal for Partners is a limited-release solution at this time. It is available to select partners for approved use cases. Two versions of the solution are available:
  • New integrations: version 2, this version (from February 2019)
  • Existing integrations: version 1 (before February 2019)

New customers should integrate version 2. For more information, reach out to your PayPal account manager.

PayPal for Partners moves money to your sellers, offering end-to-end solutions for marketplaces, crowdfunding, and other e-commerce platforms.

Solutions for partners are a combination of REST APIs and tailored PayPal products like Smart Payment Buttons.

Note: This version of PayPal for Partners requires completion of account setup by your account manager before you can test in sandbox. Use prior to account set up results in the HTTP status code of 401 Unauthorized.

Partner onboarding

  1. PayPal must vet and approve you before you can use a PayPal for Partners solution. This is the business flow you complete with your PayPal account manager.
  2. You must also register your platform with PayPal to get an access token. Use this access token for authorization when you make REST API requests. This registration begins your engineering flow.

Both business and engineering workflows are required to go live with any PayPal for Partners solution. The fastest way to go live is by starting them around the same time, so everything is ready as soon as you finish testing your integration.

Seller onboarding

You must connect your sellers, business and casual, to PayPal on your platform. This is the Connected Path seller onboarding.

Connected Path onboarding enables you to partner with PayPal to protect against and manage your risks and losses. You control funds disbursement while PayPal handles disputes and collects funds from responsible parties, taking on risk of losses.

During seller onboarding, you ask your sellers to link their PayPal account to your platform in one of two ways:

  • Upfront onboarding. Sellers connect before buyers make PayPal payments through your platform.
  • Progressive onboarding. Sellers connect after buyers make PayPal payments through your platform.

Upfront onboarding

Upfront onboarding requires you to integrate the PayPal onboarding mini-browser into your website. This lets your sellers create PayPal accounts or link existing PayPal accounts to your platform without ever leaving your experience.

Progressive onboarding

After a buyer makes a PayPal payment, your seller receives an email that a payout is waiting. The email links to the PayPal website where the seller is asked to complete steps to connect their PayPal account to your platform to get the payment. If the seller does not have a PayPal account, they will be prompted to create one.


No matter the type of onboarding, you can onboard business only or business and casual sellers. Sellers can associate any email address with PayPal.

Business sellers

PayPal Business accounts provide sellers with more advanced tools to track payments made to them through PayPal than personal accounts. If most of your sellers are businesses or organizations, you can decide that all sellers must use PayPal Business accounts.

  • In Upfront onboarding, the seller's email can be used to create either a new PayPal Business account or to log into an existing PayPal account. If the existing account is personal, the seller is given the opportunity to convert it to a business account.
  • In Progressive onboarding, if the email address used on your platform matches an existing PayPal business account, the seller will be asked to link that account. If the email address used for your platform matches an existing PayPal personal account, the seller is asked to convert the account to a business account and link it. If the email address does not match any PayPal account, the seller will be asked to create and link a new PayPal business account.

Casual sellers

If many of your sellers are people who accept payments only occasionally, you can make PayPal personal accounts the default, or you can allow sellers to choose whether they prefer to use a PayPal personal or business account, new or existing.

  • In Upfront onboarding, the seller's email can be used to create either a new PayPal account or to log into an existing PayPal account.


Begin onboarding