Update invoice payment status

amount is the optional payment amount to record

adjustment_amount is the total sum of credit notes of type "adjustment". These are non-cash reductions applied to the invoice (e.g. goodwill credit, billing correction).

amount_due is the total amount that needs to be paid for this invoice

amount_paid is the amount that has already been paid towards this invoice

amount_remaining is the outstanding amount still owed on this invoice (calculated as amount_due minus amount_paid)

billing_period describes the billing period this invoice covers (e.g., "January 2024", "Q1 2024")

billing_reason indicates why this invoice was generated (e.g., "subscription_billing", "manual_charge")

billing_sequence is the sequential number indicating the billing cycle for subscription invoices

currency is the three-letter ISO currency code (e.g., USD, EUR, GBP) that applies to all monetary amounts on this invoice

customer_id is the ID of the customer who will receive this invoice

description is an optional description or notes about this invoice

due_date is the date when payment for this invoice is due

environment_id is the ID of the environment this invoice belongs to (for multi-environment setups)

finalized_at is the timestamp when this invoice was finalized and made ready for payment

id is the unique identifier for this invoice

idempotency_key is a unique key used to prevent duplicate invoice creation when retrying API calls

invoice_number is the human-readable invoice number displayed to customers (e.g., INV-2024-001)

invoice_pdf_url is the URL where customers can download the PDF version of this invoice

issue_date is the user-facing date of the invoice. Defaults to created_at if not set.

last_computed_at is the timestamp when this invoice was last computed by ComputeInvoice

overpaid_amount is the amount overpaid if payment_status is OVERPAID (amount_paid - total)

paid_at is the timestamp when this invoice was fully paid

period_end is the end date of the billing period covered by this invoice

period_start is the start date of the billing period covered by this invoice

recalculated_invoice_id is the ID of the replacement invoice created when this invoice was voided and recalculated. When set, it forms a parent→child link from this (voided) invoice to the new replacement invoice.

refunded_amount is the total sum of credit notes of type "refund". These are actual refunds issued to the customer.

subscription_customer_id is the subscription owner's customer ID (Subscription.CustomerID). It may differ from customer_id when the subscription uses an invoicing customer. Set internally; nullable in DB.

subscription_id is the ID of the subscription this invoice is associated with (only present for subscription-based invoices)

subtotal is the sum of all line items before any taxes, discounts, or additional fees

total is the final amount including taxes, fees, and discounts

total_discount is the sum of all coupon discounts applied to the invoice

total_prepaid_credits_applied is the total amount of prepaid credits applied to this invoice.

total_tax is the sum of all taxes combined at the invoice level.

version is the version number for tracking changes to this invoice

voided_at is the timestamp when this invoice was voided or cancelled