Set up

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

Prerequisites

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.

1. Enable Tax Reporting as a Service

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

PayPal will:

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

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

2. Set up webhook notifications

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

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.
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


Event	Trigger
`TAXES.REPORTS.GENERATED`	A new tax report was generated and is ready for download. Use the `corrected` field to identify corrected reports.

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

Prerequisites

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.

1. Enable Tax Reporting as a Service

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

PayPal will:

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

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

2. Set up webhook notifications

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

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.
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


Event	Trigger
`TAXES.REPORTS.GENERATED`	A new tax report was generated and is ready for download. Use the `corrected` field to identify corrected reports.

Set up

Prerequisites

1. Enable Tax Reporting as a Service

2. Set up webhook notifications

Available webhook event

On this page

On this page

On this page

Set up

Prerequisites

1. Enable Tax Reporting as a Service

2. Set up webhook notifications

Available webhook event

On this page

On this page

Set up

On this page

On this page

On this page

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more

Set up

On this page

On this page