Set up

You can set up API access and webhook notifications to retrieve and deliver tax reports to your merchants.

Before you begin, ensure you have:

• Active PayPal Complete Payments partnership.
• REST API and webhook notification integration.
• Merchant onboarding process to collect tax information through KYC/CIP verification.

Contact your PayPal account manager to activate Tax Reporting as a Service for your partner account.

PayPal will:

1. Enable the Tax Reporting as a Service feature for your partner account.
2. Configure your account in the tax reporting platform.

After activation, PayPal provides your API credentials and partner account details for integration.

Configure webhook endpoints to receive real-time notifications about tax report events:

1. Subscribe to webhook events using one of the following methods:
   • PayPal developer account:
     1. Log in to your account.
     2. Go to App details page > Features > Webhooks.
     3. Subscribe to webhook events.
   • Webhooks management API: Use the Webhooks management API.
2. In your server-side app code, define a webhook handler that:
   • Listens to the webhook event.
   • Confirms receipt of the webhook event to PayPal.
   • Verifies the source of the event notification.
   • Parses the webhook payload received from PayPal and uses the data to deliver tax reports to merchants.

Available webhook event