Docs/Invoicing

Invoicing

Automatic professional invoices with every withdrawal: tax-compliant and multilingual.

How It Works

Every time you complete a withdrawal, Fivo automatically generates a professional PDF invoice. No manual steps required.

Withdrawal completes (funds sent to your external address)
Invoice is generated with a sequential number (e.g. FIV-2026-0001)
PDF is uploaded to secure cloud storage
Confirmation email is sent with the PDF attached
Invoice appears in your pageDashboard → Invoices

Invoice Contents

Each invoice includes a complete breakdown:

Field	Description
Invoice number	Sequential: FIV-{year}-{sequence} (e.g. FIV-2026-0001)
Issue date	Date the withdrawal completed
Issuer data	Fivo company details (name, address, tax ID)
Recipient data	Your billing details (company name, address, tax ID)
Gross amount	Total amount withdrawn before fees
Gas fee	Network gas cost for the withdrawal transaction
Fivo fee	0.5% of the gross amount
Tax	VAT/tax amount based on your country (see Tax Rules below)
Net amount	Final amount received after all deductions
Blockchain	Network used for the withdrawal
Transaction hash	On-chain transaction link for verification

Billing Data (Required)

Before your first withdrawal, you must complete 7 billing fields in . These are used to generate your invoices.Dashboard → Settings

Required before withdrawing

You cannot withdraw funds until all 7 billing fields are completed. Set them up early to avoid delays.

Billing fields

billing_typestringRequired

"business" or "individual"

billing_company_namestringRequired

Company name or full legal name

billing_tax_idstringRequired

Tax identifier (CIF, VAT number, DNI, SSN, etc.)

billing_address_line1stringRequired

Street address

billing_citystringRequired

City

billing_postal_codestringRequired

Postal / ZIP code

billing_countrystringRequired

Country code (ISO 3166-1 alpha-2, e.g. ES, US, DE)

Name	Type	Required	Description
`billing_type`	string	Required	"business" or "individual"
`billing_company_name`	string	Required	Company name or full legal name
`billing_tax_id`	string	Required	Tax identifier (CIF, VAT number, DNI, SSN, etc.)
`billing_address_line1`	string	Required	Street address
`billing_city`	string	Required	City
`billing_postal_code`	string	Required	Postal / ZIP code
`billing_country`	string	Required	Country code (ISO 3166-1 alpha-2, e.g. ES, US, DE)

Tax Rules

Tax is calculated automatically based on your billing country:

Region	Rate	Details
Spain (ES)	21% VAT	Applied to the Fivo fee. Fivo is based in Spain.
EU countries (26)	0% (reverse charge)	EU Directive 2006/112/EC, Art. 196. You declare the VAT in your country.
Rest of world	0% (exempt)	Exempt from European VAT.

EU countries with reverse charge

AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IE, IT, LV, LT, LU, MT, NL, PL, PT, RO, SK, SI, SE

22 Languages

Invoices are generated in the language of your billing country. The language is selected automatically. No configuration needed.

English

Spanish

French

German

Italian

Portuguese

Dutch

Polish

Czech

Romanian

Hungarian

Croatian

Slovak

Slovenian

Lithuanian

Latvian

Estonian

Swedish

Danish

Norwegian

Finnish

Icelandic

Accessing Invoices

There are three ways to access your invoices:

Email

PDF attached to the withdrawal confirmation email, sent automatically.

Dashboard

page: filter by year or status, download any invoice as PDF.Invoices

API

to list invoices. for a presigned download URL (15-minute expiry).GET /invoicesGET /invoices/:id/pdf