//native
/**
* Update Invoice
* Update a draft invoice. Once finalized, only a few fields (description, metadata, footer...) remain editable. Empty fields are left unchanged. `extra_params` passes any other documented field through as-is.
*/
export async function main(
auth: RT.Stripe,
invoice_id: string,
description: string | undefined,
collection_method: "charge_automatically" | "send_invoice" | undefined,
days_until_due: number | undefined,
default_payment_method: string | undefined,
metadata: { [key: string]: string } | undefined,
extra_params: { [key: string]: any } | undefined
) {
const response = await fetch(
`https://api.stripe.com/v1/invoices/${invoice_id}`,
{
method: "POST",
headers: {
Authorization: `Bearer ${auth.token}`,
"Content-Type": "application/x-www-form-urlencoded",
Accept: "application/json",
"Stripe-Version": "2025-03-31.basil",
},
body: toForm({
description,
collection_method,
days_until_due,
default_payment_method,
metadata,
...extra_params,
}),
}
)
if (!response.ok) {
throw new Error(`${response.status} ${await response.text()}`)
}
return await response.json()
}
// Stripe takes form-encoded params with bracketed nesting: metadata[key]=v, items[0][price]=p
function toForm(
params: { [key: string]: any },
prefix = "",
out = new URLSearchParams()
) {
for (const [key, value] of Object.entries(params)) {
if (value == null || value === "") continue
const name = prefix ? `${prefix}[${key}]` : key
if (typeof value === "object") toForm(value, name, out)
else out.append(name, String(value))
}
return out
}
Submitted by hugo989 3 hours ago