Saltar al contenido principal
POST
Void an invoice
v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization
string
header
requerido

Parámetros de ruta

id
string
requerido

Unique identifier of the invoice to void.

Respuesta

The voided invoice, with status set to void.

id
string
requerido

Unique identifier of the invoice.

Ejemplo:

"inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"

hosted_invoice_url
string | null
requerido

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.

Ejemplo:

"https://acme.billing.fintoc.com/invoices/inv_2bVdWxLpzXq8RkNcM3JtUv9AhTe"

object
any
requerido

Type of the object. Always invoice.

attempt_count
integer
requerido

Number of automatic charge attempts Fintoc has made on the invoice. 0 until the invoice is finalized and charged for the first time.

Ejemplo:

1

created_at
string<date-time>
requerido

ISO 8601 timestamp of when the invoice was created.

Ejemplo:

"2026-05-01T12:00:00Z"

currency
enum<string>
requerido

Currency of the invoice, as an ISO 4217 code. Every line item uses this currency.

Opciones disponibles:
CLP,
MXN
Ejemplo:

"CLP"

customer
string
requerido

id of the customer the invoice bills.

Ejemplo:

"cus_2bVdWyTnGq4PfLs7DkXjRm0CwIo"

default_payment_method
string | null
requerido

id of the payment method Fintoc charges when the invoice is finalized. null for invoices without one, such as subscription invoices.

Ejemplo:

"pm_2c4mDhAbCdEfGhIjKlMnOpQrStu"

lines
object[]
requerido

Line items that make up the invoice total.

metadata
object | null
requerido

Set of key-value pairs attached to the invoice. null when the invoice has no metadata.

mode
enum<string>
requerido

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.

Opciones disponibles:
live,
test
Ejemplo:

"live"

next_payment_attempt_at
string<date-time> | null
requerido

ISO 8601 timestamp of the next scheduled automatic charge attempt. null when no further attempt is scheduled.

Ejemplo:

"2026-05-02T12:00:00Z"

payments
object[]
requerido

Payment attempts to collect the invoice.

status
enum<string>
requerido

Status of the invoice. Invoices start as draft, become open when finalized, and end as paid or void.

Opciones disponibles:
draft,
open,
paid,
void
Ejemplo:

"draft"

subscription
string | null
requerido

id of the subscription that generated the invoice. null for invoices not tied to a subscription.

Ejemplo:

"sub_2bVdWzKfHr5QgMt8ElYkSn1DxJp"

total
integer
requerido

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.

Ejemplo:

30000