> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-management/payments/wix-payments-provider/tax-documents/introduction.md

## Article Content:

# 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](https://dev.wix.com/docs/api-reference/business-management/payments/wix-payments-provider/tax-documents/sample-flows.md#list-a-merchants-tax-documents).
- [Download a tax document's file](https://dev.wix.com/docs/api-reference/business-management/payments/wix-payments-provider/tax-documents/sample-flows.md#download-a-tax-documents-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.

@sdk_package_setup