{"title":"Provide tax forms (US only)","category":"default","creationDate":1776961628,"content":"<div class=\"additional-info-block output-inline\">\n<div class=\"additional-info-block__body\"><p>To learn more about tax forms, go to the <a href=\"https:\/\/www.irs.gov\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">IRS website<\/a>.<\/p><\/div><\/div>\n\n<p>In the US, Adyen is required to file a <strong>1099-K tax form<\/strong> with the Internal Revenue Service (IRS) for any US-based user to which Adyen pays out directly. Some states require filing of 1099-K forms as well.<\/p>\n<p><a id=\"threshold\"><\/a><br \/>\nFor 2025, Adyen is required to file 1099-K forms for all US-based users with a gross processed volume at or above the federal threshold of USD 20,000 and 200 transactions combined per calendar year. At the state level, thresholds can vary depending on the state.<\/p>\n<p>Adyen follows the IRS requirements for reporting gross processed volume prior to deduction of fees, chargebacks, and refunds.<\/p>\n<div class=\"notices green\">\n<p>Transactions with  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-splits-type\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">splits.type<\/a> <a href=\"\/pt\/platforms\/top-up-balance-account\/on-demand-top-ups\">\n  <strong>TopUp<\/strong>\n<\/a> do not count towards your users' total processed volume. These transactions are not included in their 1099-K tax forms.<\/p>\n<\/div>\n<h2 id=\"get-tax-form\">Retrieve tax forms for your users<\/h2>\n<p>Adyen makes tax forms available the third week of January for the previous tax year. For example, 1099-K forms for 2025 are available in January 2026. When the tax forms have become available, you can retrieve them using your Customer Area or API calls, and distribute them in PDF format to your users.<\/p>\n<div class=\"sc-notice info\"><div>\n<p>Adyen only generates a 1099-K tax form for user accounts that meet the volume or transaction <a href=\"#threshold\">threshold<\/a>. If your user does not meet the threshold, no tax form is available.<\/p>\n<\/div><\/div>\n\n<div id=\"tabvhTeF\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Customer Area&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To be able to download tax forms, you must have the following &lt;a href=\\&quot;\\\/pt\\\/account\\\/user-roles#platforms\\&quot;&gt;role&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Download tax form&lt;br \\\/&gt;\\nIn addition, you must have one of the following roles:&lt;\\\/li&gt;\\n&lt;li&gt;Balance platform admin&lt;\\\/li&gt;\\n&lt;li&gt;Balance platform base&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To download a tax form for a user:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;Log in to your &lt;a href=\\&quot;https:\\\/\\\/ca-test.adyen.com\\\/\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Customer Area&lt;\\\/a&gt;, and select the merchant account your account holder processes under.&lt;\\\/li&gt;\\n&lt;li&gt;Go to &lt;strong&gt;Accounts &amp;amp; balances&lt;\\\/strong&gt; &amp;gt; &lt;strong&gt;Account holders&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;Select an &lt;strong&gt;Account holder ID&lt;\\\/strong&gt; from your list of account holders.&lt;\\\/li&gt;\\n&lt;li&gt;On the &lt;strong&gt;Overview tab&lt;\\\/strong&gt;, under &lt;strong&gt;Account overview&lt;\\\/strong&gt;, select &lt;strong&gt;Download tax form&lt;\\\/strong&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;customer_area_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;API&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;You can use the  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)\\\/taxForms\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/taxForms&lt;\\\/a&gt; endpoint to get forms for the tax year 2022 and later.&lt;\\\/p&gt;\\n&lt;p&gt;As part of your implementation, ensure that your balance platform shows a button or a link for getting the tax form. When a user selects the button or link, this should trigger the API request to get the tax form for the user&#039;s account holder.&lt;\\\/p&gt;\\n&lt;p&gt;To be able to retrieve tax forms, you need a Balance Platform API key.&lt;br \\\/&gt;\\nYour API credential must have the following &lt;a href=\\&quot;\\\/pt\\\/platforms\\\/manage-access\\\/webservice-roles\\&quot;&gt;role&lt;\\\/a&gt;:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;Download Tax Form via Tax Api&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;p&gt;To retrieve a tax form for a user:&lt;\\\/p&gt;\\n&lt;ol&gt;\\n&lt;li&gt;\\n&lt;p&gt;Send a GET  &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)\\\/taxForms\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;\\\/accountHolders\\\/{id}\\\/taxForms&lt;\\\/a&gt; request, specifying the account holder ID as a path parameter, and the following query parameters:&lt;\\\/p&gt;\\n&lt;table&gt;\\n&lt;thead&gt;\\n&lt;tr&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Query parameter&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Required&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Type&lt;\\\/th&gt;\\n&lt;th style=\\&quot;text-align: left;\\&quot;&gt;Description&lt;\\\/th&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/thead&gt;\\n&lt;tbody&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)\\\/taxForms#query-legalEntity\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;legalEntity&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;string&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The legal entity reference whose tax form you want to retrieve. You can get this value from the account holder object.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)\\\/taxForms#query-formType\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;formType&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;integer&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The type of tax form you want to retrieve. Set this to &lt;strong&gt;US1099k&lt;\\\/strong&gt;, indicating a 1099-K form.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;tr&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt; &lt;a href=\\&quot;https:\\\/\\\/docs.adyen.com\\\/api-explorer\\\/balanceplatform\\\/latest\\\/get\\\/accountHolders\\\/(id)\\\/taxForms#query-year\\&quot; class=\\&quot;codeLabel  external-link no-image\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot;&gt;year&lt;\\\/a&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;&lt;img title=\\&quot;-white_check_mark-\\&quot; alt=\\&quot;-white_check_mark-\\&quot; class=\\&quot;smileys\\&quot; src=\\&quot;\\\/user\\\/data\\\/smileys\\\/emoji\\\/white_check_mark.png\\&quot; \\\/&gt;&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;string&lt;\\\/td&gt;\\n&lt;td style=\\&quot;text-align: left;\\&quot;&gt;The tax year in &lt;strong&gt;YYYY&lt;\\\/strong&gt; format for the tax form you want to retrieve.&lt;\\\/td&gt;\\n&lt;\\\/tr&gt;\\n&lt;\\\/tbody&gt;\\n&lt;\\\/table&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Get a tax form&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;bash&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl https:\\\\\\\/\\\\\\\/balanceplatform-api-test.adyen.com\\\\\\\/bcl\\\\\\\/v2\\\\\\\/accountHolders\\\\\\\/AH00000000000000000000001\\\\\\\/taxForms?legalEntity=LE00000000000000000000005&amp;amp;formType=US1099k&amp;amp;year=2022  \\\\\\\\\\\\n-H &#039;x-api-key: ADYEN_BALANCE_PLATFORM_API_KEY&#039; \\\\\\\\\\\\n-H &#039;content-type: application\\\\\\\/json&#039; \\\\\\\\\\\\n-X GET \\\\\\\\&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;p&gt;The response contains the tax form as a Base64-encoded binary.&lt;\\\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Response&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;bash\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;content\\\\\\&quot;: \\\\\\&quot;JVBERi0xLjcKJcfsj6IKJSVJbnZvY2F0aW9uOiBwYXRoL2dzd2luNjQuZXhlIC1kRGlzcGxh\\\\\\&quot;,\\\\n    \\\\\\&quot;contentType\\\\\\&quot;: \\\\\\&quot;application\\\\\\\/pdf\\\\\\&quot;\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Use the &lt;a href=\\&quot;https:\\\/\\\/base64.guru\\\/developers\\\/java\\\/examples\\\/decode-pdf\\&quot; target=\\&quot;_blank\\&quot; rel=\\&quot;nofollow noopener noreferrer\\&quot; class=\\&quot;external-link no-image\\&quot;&gt;Base64.Decoder&lt;\\\/a&gt; class to decode the Base64 binary from the response and convert it to PDF.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;li&gt;\\n&lt;p&gt;Provide the user with the PDF copy of their tax form.&lt;\\\/p&gt;\\n&lt;\\\/li&gt;\\n&lt;\\\/ol&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;api_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h2>See also<\/h2>\n<ul>\n<li><a href=\"\/pt\/platforms\/us-tax-forms-edelivery-consent\">Set consent for paperless delivery of tax forms (US only)<\/a><\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/pt\/platforms\/us-tax-forms","articleFields":{"description":"Provide a 1099-K or 1099-NEC tax form to your users.","type":"page","feedback_component":true,"page_id":"57858081-41ca-450e-8c0b-4966252aeba1","filters_component":false,"decision_tree":"[]","parameters":{"directoryPath":"\/platforms","model":"platform"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/platforms\/us-tax-forms","title":"Provide tax forms (US only)","content":"\nTo learn more about tax forms, go to the IRS website.\n\nIn the US, Adyen is required to file a 1099-K tax form with the Internal Revenue Service (IRS) for any US-based user to which Adyen pays out directly. Some states require filing of 1099-K forms as well.\n\nFor 2025, Adyen is required to file 1099-K forms for all US-based users with a gross processed volume at or above the federal threshold of USD 20,000 and 200 transactions combined per calendar year. At the state level, thresholds can vary depending on the state.\nAdyen follows the IRS requirements for reporting gross processed volume prior to deduction of fees, chargebacks, and refunds.\n\nTransactions with  splits.type \n  TopUp\n do not count towards your users' total processed volume. These transactions are not included in their 1099-K tax forms.\n\nRetrieve tax forms for your users\nAdyen makes tax forms available the third week of January for the previous tax year. For example, 1099-K forms for 2025 are available in January 2026. When the tax forms have become available, you can retrieve them using your Customer Area or API calls, and distribute them in PDF format to your users.\n\nAdyen only generates a 1099-K tax form for user accounts that meet the volume or transaction threshold. If your user does not meet the threshold, no tax form is available.\n\n\n\n    \n        \n        \n    \n\n\nSee also\n\nSet consent for paperless delivery of tax forms (US only)\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Platforms","lvl2":"Provide tax forms (US only)"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/platforms","lvl2":"\/pt\/platforms\/us-tax-forms"},"levels":3,"category":"Platforms","category_color":"green","tags":["Provide","forms","only)"]}}
