Void an invoice
Voids an invoice, setting its status to void so it can no longer be paid. You can void an invoice while it is in draft or open status. Voiding an invoice that is already void returns it unchanged. You cannot void an invoice that has already been paid, or one with a payment in progress.
v2 · Base URL https://api.fintoc.com/v2Authorizations
Path Parameters
Unique identifier of the invoice to void.
Response
The voided invoice, with status set to void.
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