Finalize an invoice
Finalizes a draft invoice, moving its status to open. This is how you advance an invoice for collection: Fintoc never finalizes invoices automatically. When the invoice has a default_payment_method and its collection_method is charge_automatically, Fintoc charges the invoice right after finalizing. Finalizing an invoice that is already open, or a zero-amount invoice that Fintoc already marked as paid, returns the invoice unchanged. You cannot finalize a paid invoice with a positive total or a void invoice.
v2 · Base URL https://api.fintoc.com/v2Autorizaciones
Parámetros de ruta
Unique identifier for the invoice to finalize.
Respuesta
The invoice after the finalize request succeeds.
Unique identifier of the invoice.
"inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"
URL of the hosted invoice page, where your customer can view and pay the invoice. null for test mode invoices and for invoices that are not open.
"https://acme.billing.fintoc.com/invoices/inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"
Type of the object. Always invoice.
Number of automatic charge attempts Fintoc has made on the invoice. 0 until the invoice is finalized and charged for the first time.
1
ISO 8601 timestamp of when the invoice was created.
"2026-05-01T12:00:00Z"
Currency of the invoice, as an ISO 4217 code. Every line item uses this currency.
CLP, MXN "CLP"
id of the customer the invoice bills.
"cus_2bVdWyTnGq4PfLs7DkXjRm0CwIo"
id of the payment method Fintoc charges when the invoice is finalized. null for invoices without one, such as subscription invoices.
"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu"
Line items that make up the invoice total.
Set of key-value pairs attached to the invoice. null when the invoice has no metadata.
Mode of the invoice. live invoices use real data; test invoices use fake data for integration testing. An API key only sees invoices that share its mode.
live, test "live"
ISO 8601 timestamp of the next scheduled automatic charge attempt. null when no further attempt is scheduled.
"2026-05-02T12:00:00Z"
Payment attempts to collect the invoice.
Status of the invoice. Invoices start as draft, become open when finalized, and end as paid or void.
draft, open, paid, void "draft"
id of the subscription that generated the invoice. null for invoices not tied to a subscription.
"sub_2bVdWzKfHr5QgMt8ElYkSn1DxJp"
Total amount of the invoice, in the smallest unit of currency (for example, 30000 for $30000 CLP, since CLP has no minor unit, or 3000 for $30.00 MXN). Equals the sum of the line item amounts.
30000