> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# invoices_update

> Update an invoice. Parameters not provided are left unchanged. Monetary values and the collection method stop being editable once it is finalised.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://api.stripe.com/v1/invoices/{invoice}"}</code></div>

```python stripe_invoices_update.py theme={null}
from charter.packs import stripe

result = await stripe.invoices_update.ainvoke({"invoice": ...})
```

## Path parameters

<div className="reference-table">
  | Field                                                           | Type     | Description            |
  | --------------------------------------------------------------- | -------- | ---------------------- |
  | `invoice` <span className="required" title="required">\*</span> | `string` | The ID of the invoice. |
</div>

## Body

<div className="reference-table">
  | Field                  | Type                                                                                        | Description                                                                                                                                           |
  | ---------------------- | ------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `description`          | `string`                                                                                    | An arbitrary string attached to the invoice. Shown as the memo in the Dashboard.                                                                      |
  | `metadata`             | map of `string`                                                                             | Set of key-value pairs attached to the invoice.                                                                                                       |
  | `autoAdvance`          | `boolean`                                                                                   | Whether Stripe collects the invoice automatically. False leaves the invoice where it is until you act on it.                                          |
  | `collectionMethod`     | [CollectionMethod](/charter/charter/packs/stripe/subscriptions/objects#collectionmethod)            | How to collect payment. Absent, Stripe charges the customer's default payment method.                                                                 |
  | `daysUntilDue`         | `integer`                                                                                   | Days until the invoice is due. Valid only when `collection_method` is 'send\_invoice'. <span className="field-constraints">≥ 0</span>                 |
  | `dueDate`              | `integer`                                                                                   | Unix timestamp when payment is due. Valid only when `collection_method` is 'send\_invoice'. Seconds, not milliseconds: 1700000000, not 1700000000000. |
  | `defaultPaymentMethod` | `string`                                                                                    | The payment method to charge. It must belong to the invoice's customer.                                                                               |
  | `footer`               | `string`                                                                                    | Footer text displayed on the invoice.                                                                                                                 |
  | `statementDescriptor`  | `string`                                                                                    | What the customer sees on their card statement. Must contain at least one letter.                                                                     |
  | `onBehalfOf`           | `string`                                                                                    | The connected account the funds are intended for. Its branding and support information appear on the invoice.                                         |
  | `discounts`            | [SubscriptionDiscount](/charter/charter/packs/stripe/subscriptions/objects#subscriptiondiscount)\[] | Coupons and promotion codes. A populated array replaces the invoice's existing discounts. Absent, they are left alone.                                |
</div>