OrderUpdateInput

Post the order's invoices as soon as the billing run makes them. Null or false, they wait as drafts for you to post.

Email each invoice when it is posted, and reminders on its due date and 3, 7 and 14 days after while it is unpaid (unless Stripe is collecting it). A credit invoice (a negative total) is emailed as a credit, and an invoice with a zero total as one with nothing to pay; an invoice that owes nothing gets no reminders. They go to the billing contacts, else the customer's billing contacts, else the customer's email. Null or false, no emails.

Email a receipt when an invoice is paid in full, stating the amount of the payment that settled it, unless nothing was paid (its total is zero or less, or Stripe settled it from the customer's Stripe balance). Null or false, no receipt.

The day of the month the order's billing periods start, fixed once the order isn't a draft. Defaults to the start date's day. In shorter months the period starts on the month's last day. When the start date falls on another day, the first period runs from the start date to the first anchor day and is prorated.

The contacts (con_…) who receive this order's invoices. Each must be a contact of the customer or of the billing customer (400 otherwise); duplicates are dropped. Create contacts with Create a contact.

Another customer who pays for this order. Answers 404 when there is no such customer.

Months in each billing period when billingFrequencyOverride is custom, a whole number from 1 to 60 (400 otherwise). Default 1. Fixed once the order isn't a draft.

Bill the order's recurring and seat-based charges at this frequency (monthly, quarterly, semiAnnually, annual, or custom for every billingFrequencyCustomMonths months) instead of each charge's own. Usage and one-time charges keep theirs. Fixed once the order isn't a draft.

Must be the order's current creationState if sent.

The day the order ends, as a date or date-time. Null removes the end date.

Your ID for the order, unique among your orders. Null clears it.

Your own key-value data, kept with the record and returned as sent.

The order's new name.

When the order's invoices fall due, counted from when each is posted. Null for 14 days.

Your customer's purchase order reference, shown on the order's invoices.

The day the order starts, as a date (YYYY-MM-DD) or ISO 8601 date-time.

Your subscription terms for the order (term length, renewal), kept with the order and returned as sent.