Saltar al contenido principal
PATCH
Update an invoice line item
v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization
string
header
requerido

Parámetros de ruta

invoice_id
string
requerido

The id of the invoice the line item belongs to.

id
string
requerido

The id of the line item to update.

Cuerpo

application/json
amount
integer

New amount of the line item, in the smallest unit of currency (for example, 30000 for $30000 CLP, since CLP has no minor unit, or 3000 for $30.00 MXN). Must be greater than 0.

Ejemplo:

80000

currency
enum<string>

New currency of the line item, as an ISO 4217 code. Must match the invoice currency.

Opciones disponibles:
CLP,
MXN
Ejemplo:

"CLP"

period_end
string<date-time>

New ISO 8601 timestamp marking the end of the billing period covered by the line item. Must remain after period_start.

Ejemplo:

"2026-06-01T00:00:00Z"

period_start
string<date-time>

New ISO 8601 timestamp marking the start of the billing period covered by the line item.

Ejemplo:

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

quantity
integer

New number of units billed by the line item. Must be greater than 0.

Ejemplo:

2

name
string

New display name for the line item shown on the invoice.

Ejemplo:

"Premium Plan"

description
string

New additional details about the line item shown on the invoice.

Ejemplo:

"A premium plan"

Respuesta

The updated line item. The invoice total already reflects the new amount.

id
string
requerido

Unique identifier of the line item.

Ejemplo:

"il_2bVdX0PqJs6RhNu9FmZlTo2EyKq"

object
any
requerido

Type of the object. Always line_item.

amount
integer
requerido

Amount of the line item, in the smallest unit of currency (for example, 30000 for $30000 CLP, since CLP has no minor unit, or 3000 for $30.00 MXN).

Ejemplo:

30000

currency
enum<string>
requerido

Currency of the line item, as an ISO 4217 code. Always matches the invoice currency.

Opciones disponibles:
CLP,
MXN
Ejemplo:

"CLP"

description
string | null
requerido

Additional details about the line item shown on the invoice. null when the line item has no description.

Ejemplo:

"A premium plan"

name
string
requerido

Display name for the line item shown on the invoice.

Ejemplo:

"Premium Plan"

period_end
string<date-time> | null
requerido

ISO 8601 datetime in UTC marking the end of the billing period covered by the line item. null for line items on invoices not tied to a subscription.

Ejemplo:

"2026-06-01T00:00:00Z"

period_start
string<date-time> | null
requerido

ISO 8601 datetime in UTC marking the start of the billing period covered by the line item. null for line items on invoices not tied to a subscription.

Ejemplo:

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

quantity
integer
requerido

Number of units billed by the line item.

Ejemplo:

1