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

Autorizaciones

Authorization
string
header
requerido

Parámetros de ruta

id
string
requerido

The id of the invoice to remove line items from.

Cuerpo

application/json
lines
string[]
requerido

ids of the line items to remove from the invoice. Must contain at least one id, and every id must belong to a line item of the invoice.

Minimum array length: 1

Respuesta

The updated invoice, without the removed line items and with the recalculated total.

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