Tax Details for Nota Fiscal

Available exclusively for businesses in Brazil 🇧🇷

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 this is required #

The Brazilian tax data form is required for payment scenarios where Nota Fiscal must be issued, including (but not limited to):

• Subscription payments
• Balance top-ups
• Purchasing additional options (and other NF-relevant payment types)

If mandatory data is missing, payment cannot proceed until the form is completed.

What data is collected #

Altegio collects two groups of information:

1. Legal Entity type and tax identifier

• Business > CNPJ
• Individual person > CPF

2. Brazil billing address

• The billing address is entered via structured fields (not a single free-text field).
• The same structured address form is used anywhere billing address editing is available (Settings and Payment flows).

Choosing CPF vs CNPJ #

Altegio does not automatically detect whether the payer is a company or an individual. The client must choose the correct option in the form:

• Choose Business (CNPJ) if the payment is made by a company.
  This option is selected by default.
• Choose Individual person (CPF) only when paying as an individual.
  When CPF is selected, Altegio shows a warning/help message reminding that companies should pay using CNPJ.

Where to fill in the data #

The same Company Details form is used in two places:

1) In the payment flow #

On the payment page:

• A Company Details information block is displayed.
• Editing is done via the pencil (edit) icon, which opens the form in a modal.
• If required information is missing, Altegio shows a blocking notice and payment cannot continue until all mandatory fields are filled.

After saving:

• Altegio persists the details.
• The payment continues.

2) In Settings #

The same form is available in Settings (Company Details section) and uses the same structure and validation rules.

Required fields and validation #

Real-time validation #

Altegio validates the format of CPF/CNPJ during input (real-time validation).

Country-specific requiredness #

• Brazil: required fields are enforced.

Business (CNPJ) #

The form includes:

• CNPJ
• Company legal name
• Brazil structured billing address fields

Individual person (CPF) #

The form includes:

• CPF
• Name (pre-filled from the user profile, editable)
• Brazil structured billing address fields

Saving, reuse, and repeat payments #

Collected Brazilian tax and billing details are stored and reused:

• Saved data is auto-populated for repeat and recurring payments.
• Where supported, the same saved data is passed into the payment provider’s form automatically.

How Nota Fiscal uses this data #

NF issuing uses the saved data from the Altegio database.

NF issuing no longer relies on payment provider fields or payment metadata for these details.

This approach applies across all payment types where Nota Fiscal is issued, not only subscriptions.