{"title":"Register consent for paperless delivery of tax forms (US only)","category":"default","creationDate":1776961627,"content":"<p>In the United States (US), Adyen is required to file a <strong>1099-K<\/strong> tax form with the Internal Revenue Service (IRS) for any US-based user to which Adyen pays out directly. This filing process also includes printing and mailing the tax form to each legal entity associated with the users in your balance platform. The form is mailed to the address registered with Adyen for each legal entity. <\/p>\n<p>If you want to save on the cost of having tax forms printed and mailed to your users through Adyen, you must gather your users' express consent to receive the forms in electronic format only, and register that consent with Adyen. <\/p>\n<p>If users agreed to receive their 1099-K tax forms in electronic format only, your marketplace is responsible for <a href=\"\/pt\/marketplaces\/us-tax-forms\">providing electronic delivery<\/a> of, and access to, 1099-K tax form(s).  <\/p>\n<h2>Requirements<\/h2>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">You must have an Adyen for Platforms marketplace integration to use this feature.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/marketplaces\/manage-access\/api-credentials-web-service\/\">API credentials<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">Make sure that you have the following API credential(s) <ul><li>LEM API key<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong><a href=\"\/pt\/development-resources\/webhooks\/configure-and-manage\">Webhooks<\/a><\/strong><\/td>\n<td style=\"text-align: left;\">No webhook is needed for the API endpoints described on this page.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"meeting-electronic-delivery-requirements\">Meeting Adyen (and IRS) electronic delivery requirements<\/h2>\n<p>When implementing this feature, consider the following:<\/p>\n<ul>\n<li>\n<p><strong>IRS requirements<\/strong>: The IRS publishes a set of specific requirements for providing tax information returns electronically <a href=\"https:\/\/www.irs.gov\/forms-pubs\/about-publication-1179\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">(IRS Publication 1179 - Section 4.6)<\/a>. You must comply with these requirements when offering electronic delivery only of tax form 1099-K to your users.  <\/p>\n<\/li>\n<li>\n<p><strong>Client presentation of electronic delivery preferences<\/strong>: As part of your implementation of this feature, you must present a way in your client interface for your marketplace's users to view and set their preference for electronic delivery of tax form 1099-K.<br \/>\nFor example, you can show a toggle switch, a checkbox, or some other UI element, and bind their consent preference (<strong>true<\/strong> or <strong>false<\/strong>) to that UI element.<br \/>\nYour electronic delivery preferences selection page must present information about a user's rights according to rules the IRS has for providing tax information returns electronically, and for providing continuous access to those returns.  <\/p>\n<\/li>\n<li>\n<p><strong>Electronic delivery of tax forms is your marketplace's responsibility<\/strong>: In addition to the collection and registration of user consent for electronic delivery with Adyen, your marketplace is responsible for <a href=\"\/pt\/marketplaces\/us-tax-forms\">providing electronic delivery<\/a> of, and continued access to, their 1099-K tax form(s). <\/p>\n<\/li>\n<li>\n<p><strong>Deadline for registering electronic delivery consent<\/strong>: To make sure Adyen does not charge your marketplace to print and mail forms to your users, their consent for electronic delivery of tax forms must be registered with Adyen by 11:59 pm Eastern Time, on December 31 in the year for which the user wants their tax forms electronically delivered.<\/p>\n<\/li>\n<\/ul>\n<h2>How it works<\/h2>\n<p>To check and register a user's consent for electronic delivery for 1009-K tax forms: <\/p>\n<ol>\n<li>Implement a way in your client interface to let your marketplace's users view and set their consent preference for receiving their tax information forms electronically.<br \/>\nFor example, you can show a toggle switch, a checkbox, or some other UI element, and bind their consent preference (<strong>true<\/strong> or <strong>false<\/strong>) to that UI element.<\/li>\n<li>Before you initialize and load your preferences page, make an API call to <a href=\"#check-electronic-delivery-consent-setting\">check your user's existing electronic delivery consent setting<\/a> with Adyen.<\/li>\n<li>Present your user's consent setting on your preferences page.<\/li>\n<li>When your user decides to allow (or revoke) their consent for electronic delivery, make an API call to <a href=\"#register-electronic-delivery-consent-setting\">register that consent preference with Adyen<\/a>. <\/li>\n<li>Make sure you have implemented <a href=\"\/pt\/marketplaces\/us-tax-forms\">providing electronic delivery<\/a> of, and access to, 1099-K tax form(s).  <\/li>\n<\/ol>\n<h2 id=\"check-electronic-delivery-consent-setting\">Check a user's electronic delivery consent preference<\/h2>\n<p>There are various reasons for checking the consent preferences of your users. For example, you could audit the number of users who have not opted for paperless delivery to determine the cost associated with mailing forms. You could also check so that you can urge your users to select paperless delivery before the deadline to register their consent preference.<\/p>\n<p>You can only check a user's paperless delivery consent preference using the API. This feature is not available through the Customer Area.<\/p>\n<p>To check a user's consent preference:<\/p>\n<ol>\n<li>\n<p><a href=\"\/pt\/marketplaces\/manage-account-holders\/?tab=ah-api_2#get-account-holders\">Find the unique legal entity ID of the account holder<\/a> whose consent status you want to check.<\/p>\n<\/li>\n<li>\n<p>Make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\/(id)\/checkTaxElectronicDeliveryConsent\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities\/{id}\/checkTaxElectronicDeliveryConsent<\/a> request, specifying the account holder's legal entity ID as a path parameter:  <\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Path parameter<\/th>\n<th style=\"text-align: left;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\/(id)\/checkTaxElectronicDeliveryConsent#path-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a><\/td>\n<td style=\"text-align: left;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The unique identifier of the legal entity. For a sole proprietorship, this is the individual legal entity ID of the owner. For an organization, this is the ID of the organization.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Check electronic delivery consent preference'\" :id=\"'check-consent-example-request'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/kyc-test.adyen.com\\\/lem\\\/v3\\\/legalEntities\\\/LE00000000000000001\\\/checkTaxElectronicDeliveryConsent \\\\\\n-H 'x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v33.0.0\\nimport com.adyen.Client;\\nimport com.adyen.enums.Environment;\\nimport com.adyen.model.legalentitymanagement.*;\\nimport java.time.OffsetDateTime;\\nimport java.util.*;\\nimport com.adyen.service.legalEntityManagement.*;\\n\\nClient client = new Client(\\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, Environment.TEST);\\n\\\/\\\/ Send the request\\nTaxEdeliveryConsentApi service = new TaxEdeliveryConsentApi(client);\\nCheckTaxElectronicDeliveryConsentResponse response = service.checkStatusOfConsentForElectronicDeliveryOfTaxForms(\\&quot;id\\&quot;, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;&lt;?php\\n\\\/\\\/ Adyen PHP API Library v24.0.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Service\\\\LegalEntityManagement\\\\TaxEdeliveryConsentApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\\/\\\/ Send the request\\n$service = new TaxEdeliveryConsentApi($client);\\n$response = $service-&gt;checkStatusOfConsentForElectronicDeliveryOfTaxForms('id');&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v27.0.0\\nusing Adyen;\\nusing Environment = Adyen.Model.Environment;\\nusing Adyen.Model;\\nusing Adyen.Model.LegalEntityManagement;\\nusing Adyen.Service.LegalEntityManagement;\\n\\nvar config = new Config()\\n{\\n    XApiKey = \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Send the request\\nvar service = new TaxEdeliveryConsentService(client);\\nvar response = service.CheckStatusOfConsentForElectronicDeliveryOfTaxForms(\\&quot;id\\&quot;);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nconst { Client, LegalEntityManagementAPI } = require('@adyen\\\/api-library');\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Send the request\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\nconst response = legalEntityManagementAPI.TaxEdeliveryConsentApi.checkStatusOfConsentForElectronicDeliveryOfTaxForms(\\&quot;id\\&quot;);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v16.3.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v16\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v16\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v16\\\/src\\\/legalEntityManagement\\&quot;\\n)\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Send the request\\nservice := client.LegalEntityManagement()\\nreq := service.TaxEdeliveryConsentApi.CheckStatusOfConsentForElectronicDeliveryOfTaxFormsInput(\\&quot;id\\&quot;)\\nres, httpRes, err := service.TaxEdeliveryConsentApi.CheckStatusOfConsentForElectronicDeliveryOfTaxForms(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v13.3.0\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\n# Send the request\\nresult = adyen.legalEntityManagement.tax_edelivery_consent_api.check_status_of_consent_for_electronic_delivery_of_tax_forms(id=\\&quot;id\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v10.1.1\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Send the request\\nresult = adyen.legalEntityManagement.tax_edelivery_consent_api.check_status_of_consent_for_electronic_delivery_of_tax_forms('id')&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v23.3.0\\nimport { Client, LegalEntityManagementAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\nconst client = new Client({ apiKey: \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot; });\\n\\n\\\/\\\/ Send the request\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\nconst response = legalEntityManagementAPI.TaxEdeliveryConsentApi.checkStatusOfConsentForElectronicDeliveryOfTaxForms(\\&quot;id\\&quot;);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>In the response, check the value for <code>US1099k<\/code>. This field contains the legal entity's 1099-K electronic delivery consent preference registered with Adyen. If the value for <code>US1099k<\/code> is <strong>true<\/strong>, your platform is responsible for <a href=\"\/pt\/marketplaces\/us-tax-forms\">providing electronic delivery<\/a> of, and access to, 1099-K tax form(s) when they become available. <\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Response parameter<\/th>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\/(id)\/checkTaxElectronicDeliveryConsent#responses-200-US1099k\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">US1099k<\/a><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\">The electronic delivery consent setting for the legal entity. The default value is <strong>false<\/strong>. If set to <strong>true<\/strong>, your marketplace is responsible for providing electronic delivery and access to their 1099-K tax form(s).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Response: electronic delivery consent registration is false'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"US1099k\\\" : false\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<h2>Register a user's electronic delivery consent preference<\/h2>\n<p>You can only register a user's electronic delivery preference using the API. This feature is not available through the Customer Area. <\/p>\n<ol>\n<li>\n<p><a href=\"\/pt\/marketplaces\/manage-account-holders\/?tab=ah-api_2#get-account-holders\">Find the unique legal entity ID of the account holder<\/a> whose consent status you want to check.<\/p>\n<\/li>\n<li>\n<p>Before presenting your electronic delivery preferences page, check your user's existing electronic delivery consent setting.<br \/>\nMake a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\/(id)\/checkTaxElectronicDeliveryConsent\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities\/{id}\/checkTaxElectronicDeliveryConsent<\/a> request, specifying the account holder's legal entity ID as a path parameter:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Path parameter<\/th>\n<th style=\"text-align: left;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\/(id)\/checkTaxElectronicDeliveryConsent#path-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a><\/td>\n<td style=\"text-align: left;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The unique identifier of the legal entity. For a sole proprietorship, this is the individual legal entity ID of the owner. For an organization, this is the ID of the organization.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<li>\n<p>Based on the boolean value of the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\/(id)\/checkTaxElectronicDeliveryConsent#responses-200-US1099k\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">US1099k<\/a> parameter in the response, present your user's electronic delivery consent setting.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Request parameter<\/th>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\/(id)\/checkTaxElectronicDeliveryConsent#responses-200-US1099k\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">US1099k<\/a><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\">Consent to electronically deliver US 1099-K tax forms.<\/br><\/br>By default, the value is <strong>false<\/strong>. Set to <strong>true<\/strong> to register consent for paperless delivery. If set to <strong>true<\/strong>, your marketplace is responsible for providing electronic delivery and access to their 1099-K tax form(s).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Response: electronic delivery consent registration is false'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n   \\\"US1099k\\\" : false\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>If the user selects paperless delivery for their 1099-K tax form, make a POST  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\/(id)\/setTaxElectronicDeliveryConsent\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/legalEntities\/{id}\/setTaxElectronicDeliveryConsent<\/a> request, specifying the legal entity ID of the user as a path parameter, and <code>US1099k<\/code> as a request parameter with the value set to <strong>true<\/strong>.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Path parameter<\/th>\n<th style=\"text-align: left;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\/(id)\/checkTaxElectronicDeliveryConsent#path-id\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">id<\/a><\/td>\n<td style=\"text-align: left;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The unique identifier of the legal entity. For a sole proprietorship, this is the individual legal entity ID of the owner. For an organization, this is the ID of the organization.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Request parameter<\/th>\n<th style=\"text-align: left;\">Required<\/th>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"> <a href=\"https:\/\/docs.adyen.com\/api-explorer\/legalentity\/latest\/post\/legalEntities\/(id)\/setTaxElectronicDeliveryConsent#request-US1099k\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">US1099k<\/a><\/td>\n<td style=\"text-align: left;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">boolean<\/td>\n<td style=\"text-align: left;\">Consent to electronically deliver US 1099-K tax form.<\/br><\/br>By default, the value is <strong>false<\/strong>. Set to <strong>true<\/strong> to register consent for paperless delivery. If set to <strong>true<\/strong>, your marketplace is responsible for providing electronic delivery and access to their 1099-K tax form(s).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Set electronic delivery consent preference to true'\" :id=\"'set-consent-example-true'\" :code-data=\"[{&quot;language&quot;:&quot;bash&quot;,&quot;tabTitle&quot;:&quot;curl&quot;,&quot;content&quot;:&quot;curl https:\\\/\\\/kyc-test.adyen.com\\\/lem\\\/v3\\\/legalEntities\\\/LE00000000000000001\\\/setTaxElectronicDeliveryConsent \\\\\\n-H 'x-api-key: ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY' \\\\\\n-H 'content-type: application\\\/json' \\\\\\n-X POST \\\\\\n-d '{\\n    \\&quot;US1099k\\&quot;: true\\n}'&quot;},{&quot;language&quot;:&quot;java&quot;,&quot;tabTitle&quot;:&quot;Java&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Java API Library v29.1.0\\nimport com.adyen.Client;\\nimport com.adyen.enums.Environment;\\nimport com.adyen.model.legalEntityManagement.*;\\nimport java.time.OffsetDateTime;\\nimport java.util.*;\\nimport com.adyen.service.legalEntityManagement.*;\\n\\nClient client = new Client(\\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, Environment.TEST);\\n\\n\\\/\\\/ Create the request object(s)\\nSetTaxElectronicDeliveryConsentRequest setTaxElectronicDeliveryConsentRequest = new SetTaxElectronicDeliveryConsentRequest()\\n  .US1099k(true);\\n\\n\\\/\\\/ Send the request\\nTaxEdeliveryConsentApi service = new TaxEdeliveryConsentApi(client);\\nservice.setConsentStatusForElectronicDeliveryOfTaxForms(\\&quot;id\\&quot;, setTaxElectronicDeliveryConsentRequest, null);&quot;},{&quot;language&quot;:&quot;php&quot;,&quot;tabTitle&quot;:&quot;PHP&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen PHP API Library v21.0.0\\nuse Adyen\\\\Client;\\nuse Adyen\\\\Environment;\\nuse Adyen\\\\Model\\\\LegalEntityManagement\\\\SetTaxElectronicDeliveryConsentRequest;\\nuse Adyen\\\\Service\\\\LegalEntityManagement\\\\TaxEdeliveryConsentApi;\\n\\n$client = new Client();\\n$client-&gt;setXApiKey(\\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;);\\n$client-&gt;setEnvironment(Environment::TEST);\\n\\n\\n\\\/\\\/ Create the request object(s)\\n$setTaxElectronicDeliveryConsentRequest = new SetTaxElectronicDeliveryConsentRequest();\\n$setTaxElectronicDeliveryConsentRequest\\n  -&gt;setUS1099k(true);\\n\\n\\\/\\\/ Send the request\\n$service = new TaxEdeliveryConsentApi($client);\\n$service-&gt;setConsentStatusForElectronicDeliveryOfTaxForms('id', $setTaxElectronicDeliveryConsentRequest);&quot;},{&quot;language&quot;:&quot;cs&quot;,&quot;tabTitle&quot;:&quot;C#&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen .net API Library v22.0.0\\nusing Adyen;\\nusing Environment = Adyen.Model.Environment;\\nusing Adyen.Model;\\nusing Adyen.Model.LegalEntityManagement;\\nusing Adyen.Service.LegalEntityManagement;\\n\\nvar config = new Config()\\n{\\n    XApiKey = \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;,\\n    Environment = Environment.Test\\n};\\nvar client = new Client(config);\\n\\n\\\/\\\/ Create the request object(s)\\nSetTaxElectronicDeliveryConsentRequest setTaxElectronicDeliveryConsentRequest = new SetTaxElectronicDeliveryConsentRequest\\n{\\n  US1099k = true\\n};\\n\\n\\\/\\\/ Send the request\\nvar service = new TaxEdeliveryConsentService(client);\\nservice.SetConsentStatusForElectronicDeliveryOfTaxForms(\\&quot;id\\&quot;, setTaxElectronicDeliveryConsentRequest);&quot;},{&quot;language&quot;:&quot;js&quot;,&quot;tabTitle&quot;:&quot;NodeJS (JavaScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v20.0.0\\n\\\/\\\/ Require the parts of the module you want to use\\nconst { Client, LegalEntityManagementAPI } = require('@adyen\\\/api-library');\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Create the request object(s)\\nconst setTaxElectronicDeliveryConsentRequest = {\\n  US1099k: true\\n}\\n\\n\\\/\\\/ Send the request\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\nlegalEntityManagementAPI.TaxEdeliveryConsentApi.setConsentStatusForElectronicDeliveryOfTaxForms(\\&quot;id\\&quot;, setTaxElectronicDeliveryConsentRequest);&quot;},{&quot;language&quot;:&quot;go&quot;,&quot;tabTitle&quot;:&quot;Go&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Go API Library v14.0.0\\nimport (\\n  \\&quot;context\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/common\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/adyen\\&quot;\\n  \\&quot;github.com\\\/adyen\\\/adyen-go-api-library\\\/v9\\\/src\\\/legalEntityManagement\\&quot;\\n)\\nclient := adyen.NewClient(&amp;common.Config{\\n  ApiKey:      \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;,\\n  Environment: common.TestEnv,\\n})\\n\\n\\\/\\\/ Create the request object(s)\\nsetTaxElectronicDeliveryConsentRequest := legalEntityManagement.SetTaxElectronicDeliveryConsentRequest{\\n  US1099k: common.PtrBool(true),\\n}\\n\\n\\\/\\\/ Send the request\\nservice := client.LegalEntityManagement()\\nreq := service.TaxEdeliveryConsentApi.SetConsentStatusForElectronicDeliveryOfTaxFormsInput(\\&quot;id\\&quot;).SetTaxElectronicDeliveryConsentRequest(setTaxElectronicDeliveryConsentRequest)\\nservice.TaxEdeliveryConsentApi.SetConsentStatusForElectronicDeliveryOfTaxForms(context.Background(), req)&quot;},{&quot;language&quot;:&quot;py&quot;,&quot;tabTitle&quot;:&quot;Python&quot;,&quot;content&quot;:&quot;# Adyen Python API Library v12.7.1\\nimport Adyen\\n\\nadyen = Adyen.Adyen()\\nadyen.client.xapikey = \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;\\nadyen.client.platform = \\&quot;test\\&quot; # The environment to use library in.\\n\\n# Create the request object(s)\\njson_request = {\\n  \\&quot;US1099k\\&quot;: True\\n}\\n\\n# Send the request\\nadyen.legalEntityManagement.tax_edelivery_consent_api.set_consent_status_for_electronic_delivery_of_tax_forms(request=json_request, id=\\&quot;id\\&quot;)&quot;},{&quot;language&quot;:&quot;rb&quot;,&quot;tabTitle&quot;:&quot;Ruby&quot;,&quot;content&quot;:&quot;# Adyen Ruby API Library v9.9.0\\nrequire \\&quot;adyen-ruby-api-library\\&quot;\\n\\nadyen = Adyen::Client.new\\nadyen.api_key = 'ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY'\\nadyen.env = :test # Set to \\&quot;live\\&quot; for live environment\\n\\n# Create the request object(s)\\nrequest_body = {\\n  :US1099k =&gt; true\\n}\\n\\n# Send the request\\nadyen.legalEntityManagement.tax_edelivery_consent_api.set_consent_status_for_electronic_delivery_of_tax_forms(request_body, 'id')&quot;},{&quot;language&quot;:&quot;ts&quot;,&quot;tabTitle&quot;:&quot;NodeJS (TypeScript)&quot;,&quot;content&quot;:&quot;\\\/\\\/ Adyen Node API Library v20.0.0\\n\\\/\\\/ Require the parts of the module you want to use\\nimport { Client, LegalEntityManagementAPI, Types } from \\&quot;@adyen\\\/api-library\\&quot;;\\n\\\/\\\/ Initialize the client object\\nconst client = new Client({apiKey: \\&quot;ADYEN_LEGAL_ENTITY_MANAGEMENT_API_KEY\\&quot;, environment: \\&quot;TEST\\&quot;});\\n\\n\\\/\\\/ Create the request object(s)\\nconst setTaxElectronicDeliveryConsentRequest: Types.legalEntityManagement.SetTaxElectronicDeliveryConsentRequest = {\\n  US1099k: true\\n};\\n\\n\\\/\\\/ Send the request\\nconst legalEntityManagementAPI = new LegalEntityManagementAPI(client);\\nlegalEntityManagementAPI.TaxEdeliveryConsentApi.setConsentStatusForElectronicDeliveryOfTaxForms(\\&quot;id\\&quot;, setTaxElectronicDeliveryConsentRequest);&quot;}]\" :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>Check that you receive a <strong>200 - No Content<\/strong> HTTP status code. This indicates your request succeeded. <\/p>\n<\/li>\n<li>\n<p>Present your user's updated electronic delivery consent setting on your preference page.<\/p>\n<\/li>\n<\/ol>\n<h2>See also<\/h2>\n<ul>\n<li><a href=\"\/pt\/marketplaces\/us-tax-forms\">Provide tax forms (US only)<\/a><\/li>\n<li><a href=\"https:\/\/www.irs.gov\/forms-pubs\/about-publication-1179\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">IRS Publication 1179<\/a> - General Rules and Specifications for Substitute Forms 1096, 1098, 1099, 5498, and Certain Other Information Returns (see section 4.6).<\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/pt\/marketplaces\/us-tax-forms-edelivery-consent","articleFields":{"description":"Check and register user-consent preferences for electronic delivery of US tax forms.","type":"page","feedback_component":true,"filters_component":false,"decision_tree":"[]","parameters":{"directoryPath":"\/marketplaces","model":"marketplace"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/marketplaces\/us-tax-forms-edelivery-consent","title":"Register consent for paperless delivery of tax forms (US only)","content":"In the United States (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. This filing process also includes printing and mailing the tax form to each legal entity associated with the users in your balance platform. The form is mailed to the address registered with Adyen for each legal entity. \nIf you want to save on the cost of having tax forms printed and mailed to your users through Adyen, you must gather your users' express consent to receive the forms in electronic format only, and register that consent with Adyen. \nIf users agreed to receive their 1099-K tax forms in electronic format only, your marketplace is responsible for providing electronic delivery of, and access to, 1099-K tax form(s).  \nRequirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nYou must have an Adyen for Platforms marketplace integration to use this feature.\n\n\nAPI credentials\nMake sure that you have the following API credential(s) LEM API key\n\n\nWebhooks\nNo webhook is needed for the API endpoints described on this page.\n\n\n\nMeeting Adyen (and IRS) electronic delivery requirements\nWhen implementing this feature, consider the following:\n\n\nIRS requirements: The IRS publishes a set of specific requirements for providing tax information returns electronically (IRS Publication 1179 - Section 4.6). You must comply with these requirements when offering electronic delivery only of tax form 1099-K to your users.  \n\n\nClient presentation of electronic delivery preferences: As part of your implementation of this feature, you must present a way in your client interface for your marketplace's users to view and set their preference for electronic delivery of tax form 1099-K.\nFor example, you can show a toggle switch, a checkbox, or some other UI element, and bind their consent preference (true or false) to that UI element.\nYour electronic delivery preferences selection page must present information about a user's rights according to rules the IRS has for providing tax information returns electronically, and for providing continuous access to those returns.  \n\n\nElectronic delivery of tax forms is your marketplace's responsibility: In addition to the collection and registration of user consent for electronic delivery with Adyen, your marketplace is responsible for providing electronic delivery of, and continued access to, their 1099-K tax form(s). \n\n\nDeadline for registering electronic delivery consent: To make sure Adyen does not charge your marketplace to print and mail forms to your users, their consent for electronic delivery of tax forms must be registered with Adyen by 11:59 pm Eastern Time, on December 31 in the year for which the user wants their tax forms electronically delivered.\n\n\nHow it works\nTo check and register a user's consent for electronic delivery for 1009-K tax forms: \n\nImplement a way in your client interface to let your marketplace's users view and set their consent preference for receiving their tax information forms electronically.\nFor example, you can show a toggle switch, a checkbox, or some other UI element, and bind their consent preference (true or false) to that UI element.\nBefore you initialize and load your preferences page, make an API call to check your user's existing electronic delivery consent setting with Adyen.\nPresent your user's consent setting on your preferences page.\nWhen your user decides to allow (or revoke) their consent for electronic delivery, make an API call to register that consent preference with Adyen. \nMake sure you have implemented providing electronic delivery of, and access to, 1099-K tax form(s).  \n\nCheck a user's electronic delivery consent preference\nThere are various reasons for checking the consent preferences of your users. For example, you could audit the number of users who have not opted for paperless delivery to determine the cost associated with mailing forms. You could also check so that you can urge your users to select paperless delivery before the deadline to register their consent preference.\nYou can only check a user's paperless delivery consent preference using the API. This feature is not available through the Customer Area.\nTo check a user's consent preference:\n\n\nFind the unique legal entity ID of the account holder whose consent status you want to check.\n\n\nMake a POST  \/legalEntities\/{id}\/checkTaxElectronicDeliveryConsent request, specifying the account holder's legal entity ID as a path parameter:  \n\n\n\nPath parameter\nRequired\nDescription\n\n\n\n\n id\n\nThe unique identifier of the legal entity. For a sole proprietorship, this is the individual legal entity ID of the owner. For an organization, this is the ID of the organization.\n\n\n\n\n\n\n\n\nIn the response, check the value for US1099k. This field contains the legal entity's 1099-K electronic delivery consent preference registered with Adyen. If the value for US1099k is true, your platform is responsible for providing electronic delivery of, and access to, 1099-K tax form(s) when they become available. \n\n\n\nResponse parameter\nType\nDescription\n\n\n\n\n US1099k\nboolean\nThe electronic delivery consent setting for the legal entity. The default value is false. If set to true, your marketplace is responsible for providing electronic delivery and access to their 1099-K tax form(s).\n\n\n\n\n\n\n\n\nRegister a user's electronic delivery consent preference\nYou can only register a user's electronic delivery preference using the API. This feature is not available through the Customer Area. \n\n\nFind the unique legal entity ID of the account holder whose consent status you want to check.\n\n\nBefore presenting your electronic delivery preferences page, check your user's existing electronic delivery consent setting.\nMake a POST  \/legalEntities\/{id}\/checkTaxElectronicDeliveryConsent request, specifying the account holder's legal entity ID as a path parameter:\n\n\n\nPath parameter\nRequired\nDescription\n\n\n\n\n id\n\nThe unique identifier of the legal entity. For a sole proprietorship, this is the individual legal entity ID of the owner. For an organization, this is the ID of the organization.\n\n\n\n\n\nBased on the boolean value of the  US1099k parameter in the response, present your user's electronic delivery consent setting.\n\n\n\nRequest parameter\nType\nDescription\n\n\n\n\n US1099k\nboolean\nConsent to electronically deliver US 1099-K tax forms.By default, the value is false. Set to true to register consent for paperless delivery. If set to true, your marketplace is responsible for providing electronic delivery and access to their 1099-K tax form(s).\n\n\n\n\n\n\n\n\nIf the user selects paperless delivery for their 1099-K tax form, make a POST  \/legalEntities\/{id}\/setTaxElectronicDeliveryConsent request, specifying the legal entity ID of the user as a path parameter, and US1099k as a request parameter with the value set to true.\n\n\n\nPath parameter\nRequired\nDescription\n\n\n\n\n id\n\nThe unique identifier of the legal entity. For a sole proprietorship, this is the individual legal entity ID of the owner. For an organization, this is the ID of the organization.\n\n\n\n\n\n\nRequest parameter\nRequired\nType\nDescription\n\n\n\n\n US1099k\n\nboolean\nConsent to electronically deliver US 1099-K tax form.By default, the value is false. Set to true to register consent for paperless delivery. If set to true, your marketplace is responsible for providing electronic delivery and access to their 1099-K tax form(s).\n\n\n\n\n\n\n\n\nCheck that you receive a 200 - No Content HTTP status code. This indicates your request succeeded. \n\n\nPresent your user's updated electronic delivery consent setting on your preference page.\n\n\nSee also\n\nProvide tax forms (US only)\nIRS Publication 1179 - General Rules and Specifications for Substitute Forms 1096, 1098, 1099, 5498, and Certain Other Information Returns (see section 4.6).\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Marketplaces","lvl2":"Register consent for paperless delivery of tax forms (US only)"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/marketplaces","lvl2":"\/pt\/marketplaces\/us-tax-forms-edelivery-consent"},"levels":3,"category":"Marketplaces","category_color":"green","tags":["Register","consent","paperless","delivery","forms","only)"]}}
