Head to the IRS website to learn more about the 1099-K tax form.
In the US, payment settlement entities, like Adyen, are required to file a 1099-K tax form with the Internal Revenue Service (IRS) for any US-based entity (merchant or sub-merchant):
- To which they pay out directly.
- That has crossed the processed volume threshold set by US tax authorities.
Retrieve digital tax forms
Follow this general flow to provide your sub-merchant with a digital copy of their tax form.
- In your platform, show a button or a link for getting the tax form.
- Send an API request to get a tax form. The response returns a Base64 binary.
- Convert the received Base64 binary to PDF format and provide the sub-merchant with a PDF copy of their tax form.
Step 1. Present tax forms in your UI
In your UI, show a button or link that your sub-merchants can use to get the tax form. When a sub-merchant clicks the link or button, this should trigger the API request in the next step.
Step 2. Get a tax form
Use the /getTaxForm endpoint to generate a Base64 binary format of the sub-merchant's tax form.
From your server, make a POST /getTaxForm request, specifying:
||String||Your unique reference to the sub-merchant's account holder.|
||String||Type of the requested tax form. For example, 1099-K.|
||Integer||The applicable tax year in the YYYY format.|
A tax form is only generated for sub-merchants that hit the volume or transaction threshold. If you make an API request for an
accountHolderCode that does not hit the threshold, you will receive an error response.
The response contains:
||String||The content type of the tax form. For example,
||String||The content of the tax form in the Base64 binary format.|
Step 3. Decode Base64 binary and convert to PDF
To present the tax form to the sub-merchant, use the Base64.Decoder class. Provide the sub-merchant with a PDF copy of their tax form.