Last updated: September 14, 2026
After you integrate the Partner SDK, merchants can onboard through two main flows depending on their existing PayPal account status.
Merchants with existing verified PayPal business accounts can link their accounts to create Partner Delegated Merchant Accounts and start processing payments immediately.
Merchants with existing verified PayPal business accounts can use their verified data for instant approval and can start processing payments immediately.
CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-CREATED with account_idCUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED to confirm that all payment capabilities are activeMerchants with existing unverified PayPal business accounts must complete additional data collection and verification requirements.
CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-CREATED with account_idCUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED for verification process in progressCUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATEDCUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGEDMerchants without PayPal accounts can create a business account and a Partner Delegated Merchant Account through the embedded experience.
CUSTOMER.MANAGED-ACCOUNT.ACCOUNT-CREATED with account_idCUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED to indicate that the verification process in progressCUSTOMER.MANAGED-ACCOUNT.ACCOUNT-UPDATEDCUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED to indicate that document upload is requiredCUSTOMER.MANAGED-ACCOUNT.ACCOUNT-STATUS-CHANGED. PayPal does not send any webhooks for rejected documentsNote: To track the status of a payment, you can use either the account_id provided in webhook events or the tracking_id. Use these IDs to send GET requests and check the payment processing status. For more information on how to set up and use webhooks, see Track onboarding status.