{"id":283069,"date":"2026-03-04T10:52:04","date_gmt":"2026-03-04T10:52:04","guid":{"rendered":"https:\/\/support-landing.altegio.cloud\/support\/?post_type=docs&#038;p=283069"},"modified":"2026-03-04T10:55:34","modified_gmt":"2026-03-04T10:55:34","password":"","slug":"283069","status":"publish","type":"docs","link":"https:\/\/alteg.io\/en\/support\/knowledge-base\/283069\/","title":{"rendered":"Tax Details for Nota Fiscal"},"content":{"rendered":"\n<p><em>Available exclusively for businesses in Brazil<\/em>\u00a0\ud83c\udde7\ud83c\uddf7<br><br>To issue <strong>Nota Fiscal (NF)<\/strong> in Brazil, Altegio requires Brazilian clients to provide <strong>taxpayer details<\/strong> and a <strong>billing address<\/strong> during payment-related flows. These details are saved and reused for future payments.<\/p>\n\n\n\n<p>This article explains what data is required, where to fill it in, and how it is used.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">When this is required<\/h2>\n\n\n\n<p>The Brazilian tax data form is required for payment scenarios where <strong>Nota Fiscal must be issued<\/strong>, including (but not limited to):<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Subscription payments<\/li>\n\n\n\n<li>Balance top-ups<\/li>\n\n\n\n<li>Purchasing additional options (and other NF-relevant payment types)<\/li>\n<\/ul>\n\n\n\n<p>If mandatory data is missing, payment cannot proceed until the form is completed.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What data is collected<\/h2>\n\n\n\n<p>Altegio collects two groups of information:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Legal Entity type and tax identifier<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Business<\/strong> > <strong>CNPJ<\/strong><\/li>\n\n\n\n<li><strong>Individual person<\/strong> > <strong>CPF<\/strong><\/li>\n<\/ul>\n\n\n\n<ol start=\"2\" class=\"wp-block-list\">\n<li><strong>Brazil billing address<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The billing address is entered via <strong>structured fields<\/strong> (not a single free-text field).<\/li>\n\n\n\n<li>The same structured address form is used anywhere billing address editing is available (Settings and Payment flows).<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Choosing CPF vs CNPJ<\/h2>\n\n\n\n<p>Altegio does not automatically detect whether the payer is a company or an individual. The client must choose the correct option in the form:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Choose <strong>Business (CNPJ)<\/strong> if the payment is made by a company.<br>This option is selected by default.<\/li>\n\n\n\n<li>Choose <strong>Individual person (CPF)<\/strong> only when paying as an individual.<br>When CPF is selected, Altegio shows a warning\/help message reminding that companies should pay using CNPJ.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Where to fill in the data<\/h2>\n\n\n\n<p>The same <strong>Company Details<\/strong> form is used in two places:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">1) In the payment flow<\/h3>\n\n\n\n<p>On the payment page:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A <strong>Company Details<\/strong> information block is displayed.<\/li>\n\n\n\n<li>Editing is done via the <strong>pencil (edit)<\/strong> icon, which opens the form in a modal.<\/li>\n\n\n\n<li>If required information is missing, Altegio shows a blocking notice and payment cannot continue until all mandatory fields are filled.<\/li>\n<\/ul>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;69f363a0c122e&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"69f363a0c122e\" class=\"wp-block-image size-full wp-lightbox-container\"><img loading=\"lazy\" decoding=\"async\" width=\"926\" height=\"882\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/alteg.io\/support\/wp-content\/uploads\/2026\/03\/Screen-Shot-2026-03-04-at-14.28.21.png\" alt=\"\" class=\"wp-image-283078\" srcset=\"https:\/\/alteg.io\/support\/wp-content\/uploads\/2026\/03\/Screen-Shot-2026-03-04-at-14.28.21.png 926w, https:\/\/alteg.io\/support\/wp-content\/uploads\/2026\/03\/Screen-Shot-2026-03-04-at-14.28.21-300x286.png 300w, https:\/\/alteg.io\/support\/wp-content\/uploads\/2026\/03\/Screen-Shot-2026-03-04-at-14.28.21-768x732.png 768w, https:\/\/alteg.io\/support\/wp-content\/uploads\/2026\/03\/Screen-Shot-2026-03-04-at-14.28.21-360x343.png 360w\" sizes=\"auto, (max-width: 926px) 100vw, 926px\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\taria-label=\"Enlarge\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.imageButtonRight\"\n\t\t\tdata-wp-style--top=\"state.imageButtonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n<p>After saving:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Altegio <strong>persists<\/strong> the details.<\/li>\n\n\n\n<li>The <strong>payment continues<\/strong>.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">2) In Settings<\/h3>\n\n\n\n<p>The same form is available in <strong>Settings<\/strong> (Company Details section) and uses the same structure and validation rules.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Required fields and validation<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Real-time validation<\/h3>\n\n\n\n<p>Altegio validates the <strong>format<\/strong> of CPF\/CNPJ during input (real-time validation).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Country-specific requiredness<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Brazil:<\/strong> required fields are enforced.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Business (CNPJ)<\/h3>\n\n\n\n<p>The form includes:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CNPJ<\/strong><\/li>\n\n\n\n<li><strong>Company legal name<\/strong><\/li>\n\n\n\n<li><strong>Brazil structured billing address fields<\/strong><\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Individual person (CPF)<\/h3>\n\n\n\n<p>The form includes:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>CPF<\/strong><\/li>\n\n\n\n<li><strong>Name<\/strong> (pre-filled from the user profile, editable)<\/li>\n\n\n\n<li><strong>Brazil structured billing address fields<\/strong><\/li>\n<\/ul>\n\n\n\n<figure data-wp-context=\"{&quot;imageId&quot;:&quot;69f363a0c2378&quot;}\" data-wp-interactive=\"core\/image\" data-wp-key=\"69f363a0c2378\" class=\"wp-block-image size-full wp-lightbox-container\"><img loading=\"lazy\" decoding=\"async\" width=\"500\" height=\"684\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on--click=\"actions.showLightbox\" data-wp-on--load=\"callbacks.setButtonStyles\" data-wp-on-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/alteg.io\/support\/wp-content\/uploads\/2026\/03\/Screen-Shot-2026-03-04-at-14.54.23.png\" alt=\"\" class=\"wp-image-283132\" srcset=\"https:\/\/alteg.io\/support\/wp-content\/uploads\/2026\/03\/Screen-Shot-2026-03-04-at-14.54.23.png 500w, https:\/\/alteg.io\/support\/wp-content\/uploads\/2026\/03\/Screen-Shot-2026-03-04-at-14.54.23-219x300.png 219w, https:\/\/alteg.io\/support\/wp-content\/uploads\/2026\/03\/Screen-Shot-2026-03-04-at-14.54.23-360x492.png 360w\" sizes=\"auto, (max-width: 500px) 100vw, 500px\" \/><button\n\t\t\tclass=\"lightbox-trigger\"\n\t\t\ttype=\"button\"\n\t\t\taria-haspopup=\"dialog\"\n\t\t\taria-label=\"Enlarge\"\n\t\t\tdata-wp-init=\"callbacks.initTriggerButton\"\n\t\t\tdata-wp-on--click=\"actions.showLightbox\"\n\t\t\tdata-wp-style--right=\"state.imageButtonRight\"\n\t\t\tdata-wp-style--top=\"state.imageButtonTop\"\n\t\t>\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewBox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\" \/>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Saving, reuse, and repeat payments<\/h2>\n\n\n\n<p>Collected Brazilian tax and billing details are stored and reused:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Saved data is <strong>auto-populated<\/strong> for repeat and recurring payments.<\/li>\n\n\n\n<li>Where supported, the same saved data is passed into the payment provider\u2019s form automatically.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">How Nota Fiscal uses this data<\/h2>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p>NF issuing uses the saved data from the Altegio database.<br><br>NF issuing no longer relies on payment provider fields or payment metadata for these details.<\/p>\n<\/blockquote>\n\n\n\n<p>This approach applies across all payment types where Nota Fiscal is issued, not only subscriptions.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Available exclusively for businesses in Brazil\u00a0\ud83c\udde7\ud83c\uddf7 To issue Nota Fiscal (NF) in Brazil, Altegio requires Brazilian clients to provide taxpayer details and a billing address during payment-related flows. These details are saved and reused for future payments. This article explains what data is required, where to fill it in, and how it is used. When&hellip; <a class=\"more-link\" href=\"https:\/\/alteg.io\/en\/support\/knowledge-base\/283069\/\">Continue reading <span class=\"screen-reader-text\">Tax Details for Nota Fiscal<\/span><\/a><\/p>\n","protected":false},"author":44,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[],"doc_tag":[2086,1507],"class_list":["post-283069","docs","type-docs","status-publish","hentry","doc_tag-billing-en","doc_tag-client-en","entry"],"aioseo_notices":[],"year_month":"2026-04","word_count":467,"total_views":"11","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"lilit.m@alteg.io","author_nicename":"lilit-malteg-io","author_url":"https:\/\/alteg.io\/en\/author\/lilit-malteg-io\/"},"doc_category_info":[],"doc_tag_info":[{"term_name":"Billing","term_url":"https:\/\/alteg.io\/en\/support\/knowledge-base\/docs-tag\/billing-en\/"},{"term_name":"Client","term_url":"https:\/\/alteg.io\/en\/support\/knowledge-base\/docs-tag\/client-en\/"}],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/283069","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/users\/44"}],"replies":[{"embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/comments?post=283069"}],"version-history":[{"count":6,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/283069\/revisions"}],"predecessor-version":[{"id":283153,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/283069\/revisions\/283153"}],"wp:attachment":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/media?parent=283069"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/doc_category?post=283069"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/doc_tag?post=283069"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}