Update collection method
Changes how renewal invoices are collected for the subscription.
Authorizations
A merchant secret key (sk_…) sent as Authorization: Bearer <key>.
Headers
A unique key that makes retries safe: the same key with the same request body returns the original response instead of repeating the operation.
255Path Parameters
The subscription id (sub_…).
Body
charge_automatically, send_invoice Response
The updated subscription.
subscription Customer id (cus_…).
incomplete — created; first invoice not yet paid.
trialing — in free trial; no invoice yet (or a zero-total one).
active — most recent invoice paid; in good standing.
past_due — most recent invoice payment failed; in dunning.
unpaid — dunning exhausted; service stopped. Terminal.
canceled — terminated (immediately or at period end). Terminal.
incomplete, trialing, active, past_due, unpaid, canceled charge_automatically, send_invoice Unix epoch seconds. Start of the current billing period.
Unix epoch seconds. End of the current billing period.
Unix epoch seconds. The reference point used to compute period boundaries.
True when the subscription is scheduled to cancel at the end of the current period.
Unix epoch seconds.
The payment method used for automatic renewal charges (pm_…). Null when not set.
Unix epoch seconds. Start of the trial period. Null when the subscription was not created with a trial.
Unix epoch seconds. End of the trial period. Null when no trial.
Unix epoch seconds. When the cancellation was requested. Null while not canceled.
Unix epoch seconds. When the subscription terminated. Null while active.
Most recent invoice id (inv_…). Null before the first invoice is issued.

