About the Tax Documents API

A tax document is a tax-related form that Wix Payments issues to a merchant, such as a US IRS Form 1099-K. Use the Tax Documents API to list a Wix Payments account's tax documents and download them as PDF files.

With the Tax Documents API, you can:

• List the tax documents of a Wix Payments account.
• Retrieve a single tax document by ID, including whether its file is available to download.
• Generate a temporary URL to download a tax document's PDF file.

How tax documents are created

Wix Payments creates a tax document for a merchant when it needs to report the merchant's payment activity to a tax authority. For example, in the US, Wix Payments files a Form 1099-K for each eligible merchant every year and makes a copy available to the merchant. Wix creates and manages tax documents and their files. This API is read-only: you can't create, edit, or upload tax documents through it.

A tax document doesn't always have a file the moment it's created. Wix creates the tax document first, then attaches its PDF file once the file is ready. The downloadable field tells you whether a file is currently available.

Before you begin

It's important to note the following points before starting to code:

• The Tax Documents API is read-only. You can't create, edit, or upload tax documents through it.
• A tax document's file can be downloaded only when its downloadable field is true.
• The download URL that Generate File Download Info returns is temporary and expires 10 seconds after it's generated. Follow it immediately, and call the method again if you need a fresh URL.
• The only tax document type currently available is the US IRS Form 1099-K.

Use cases

• List a merchant's tax documents.
• Download a tax document's file.

Terminology

• Wix Payments account: A merchant's account with Wix Payments, identified by accountId. Each tax document belongs to one Wix Payments account.
• Tax document: A tax-related form that Wix Payments issues to a merchant, such as a US IRS Form 1099-K.
• 1099-K: A US IRS form that a payment settlement entity files to report a merchant's payment transactions. Wix Payments files it for eligible US merchants each year.
• Downloadable: Whether a tax document currently has a file available to download, indicated by the downloadable field.