Submit corrections

DocsLimited

Last updated: Dec 10th, 10:51pm

You can regenerate Form 1099-K after merchants update their profile information through KYC verification. PayPal processes corrections for up to 3 years after the original form generation.

When to submit corrections

You need to submit a correction request in these situations:

Merchant updates their legal name.

Merchant updates their address.

Merchant updates their TIN/SSN information.

Merchant completes KYC verification after KYC revocation.

Note: PayPal automatically enables the tax reporting capability when merchants complete KYC verification and disables it when KYC is revoked.

Correction workflow

Merchant updates information through your platform and completes KYC verification.

You submit correction request to PayPal through the API.

PayPal validates KYC and tax reporting capability, regenerates the form within 3 days, and files it with IRS and state agencies.

PayPal sends a webhook notification when the corrected form is available.

You retrieve the corrected form and deliver it to the merchant.

Verify KYC completion

Ensure the merchant completes KYC verification for their updated information before you submit a correction request. PayPal rejects correction requests when the merchant’s KYC is revoked.

Submit correction request

You can submit a correction request using one of two approaches:

Quick request

Use a valid access token and make a POST call to the /v2/taxes/reports/{reportId}/corrections endpoint to regenerate the form using the merchant’s current KYC-verified information.

Path parameter: reportId is the ID of the original report you want to correct, retrieved from the List available tax reports response.

Sample request
Sample response

1curl -X POST 'https://api-m.sandbox.paypal.com/v2/taxes/reports/11EF-A741-C86DDAC4-BE58-CF8F5BF706E8/corrections' \
2-H 'Content-Type: application/json' \
3-H 'Authorization: Bearer <ACCESS-TOKEN>' \
4-d '{
5    "type": "PROFILE_CORRECTION",
6    "requester": "USER",
7    "quick_correct": true
8}'

Parameter	Description
`type`	Type of correction request. Use `PROFILE_CORRECTION` for name, address, and TIN corrections.
`requester`	Entity requesting the correction. Use `USER` for partner-initiated corrections on behalf of merchants.
`quick_correct`	Set to `true` to regenerate the form using current verified data on file. When `true`, PayPal uses the merchant’s current KYC-verified information without requiring explicit correction details.

On successful submission, the PayPal server returns the correction request status and tracking information.

Parameter	Description	Further action
`id`	Unique identifier for the correction request.	Check correction status using this ID.
`corrected_reports`	Array of links to corrected reports. Populated when status is `COMPLETED`.	Retrieve the corrected report using the report ID from this array.

Detailed request

Use a valid access token and make a POST call to the /v2/taxes/reports/{reportId}/corrections endpoint with the specific correction details you want to apply.

Path parameter: reportId is the ID of the original report you want to correct, retrieved from the List available tax reports response.

Sample request
Sample response

1curl -X POST 'https://api-m.sandbox.paypal.com/v2/taxes/reports/11EF-A741-C86DDAC4-BE58-CF8F5BF706E8/corrections' \
2-H 'Content-Type: application/json' \
3-H 'Authorization: Bearer <ACCESS-TOKEN>' \
4-d '{
5    "type": "PROFILE_CORRECTION",
6    "requester": "USER",
7    "correction_details": {
8        "account_number": "1939261082936477870",
9        "external_id": "1939261082936477870",
10        "tier": "PERSONAL",
11        "legal_country_code": "US",
12        "primary_owner": {
13            "party_id": "1939261082936477870",
14            "names": [
15                {
16                    "full_name": "Jane Doe"
17                }
18            ],
19            "addresses": [
20                {
21                    "address_line_1": "456 Oak Avenue",
22                    "address_line_2": "Apartment 5B",
23                    "admin_area_2": "Portland",
24                    "admin_area_1": "OR",
25                    "postal_code": "97201",
26                    "country_code": "US"
27                }
28            ],
29            "documents": [
30                {
31                    "identification_number": "ABcNkzU2.0sWUvLn3D45aJK5K2mTyx1QnSxb1j3x0JOY2D3CjsKm6-E",
32                    "partial": false,
33                    "type": "SSN"
34                }
35            ]
36        }
37    }
38}'

Note: PayPal validates that the correction details match the merchant’s current KYC-verified profile before processing the correction.

Check correction status

Use a valid access token and make a GET call to the /v2/taxes/reports/{reportId}/corrections/{correctionId} endpoint.

Path parameters:

reportId is the ID of the original report, retrieved from the List available tax reports response.

correctionId is the correction request ID from the Submit correction request response.

Sample request
Sample response

1curl -X GET 'https://api-m.sandbox.paypal.com/v2/taxes/reports/11EF-A741-C86DDAC4-BE58-CF8F5BF706E8/corrections/11ED-FABB-440B8FA8-9CB0-43A289BCF687' \
2-H 'Authorization: Bearer <ACCESS-TOKEN>'

Correction statuses

Status	Description	Further action
`PENDING_INFORMATION`	PayPal requires additional information to process the correction.	Contact PayPal support for required information.
`PROCESSING_REPORT`	PayPal completes required processes and generates the corrected report.	Wait for completion or webhook notification.
`COMPLETED`	PayPal generates the corrected form and files it with IRS and state agencies.	Retrieve the corrected form using the report ID from the `corrected_reports` array.

Retrieve corrected report

Use a valid access token and make a GET call to the /v2/taxes/reports/{reportId} endpoint when the correction status is COMPLETED.

Path parameter: reportId is the corrected report ID from the corrected_reports array in the Check correction status response.

Sample request
Sample response

1curl -X GET 'https://api-m.sandbox.paypal.com/v2/taxes/reports/11ED-FAC1-508DB6F6-8C1B-42A3FDA7CBC5' \
2-H 'Authorization: Bearer <ACCESS-TOKEN>'

Handle correction webhooks

PayPal sends a TAXES.REPORTS.GENERATED webhook event when a corrected report is ready. The event includes corrected: true and original_report_id to identify the corrected report.For information about handling webhook notifications for both regular and corrected reports, see Handle webhook notifications.

Best practices

Submit correction requests only after merchants complete KYC verification.

Verify tax reporting capability is enabled before submitting corrections.

Check merchant KYC status and capability if a request fails.

Inform merchants that corrections are processed within 3 days.

Store correction request IDs and track status changes.

Limitations

Corrections can only be submitted for reports from the current year and up to 3 years prior.

Corrections to payment amounts or transaction totals are not supported. You can only correct merchant profile information such as name, address, and TIN.

Corrections require completed KYC verification and active tax reporting capability.