cfw-autumn/others/python-sdk/docs/models/updatesubscriptionparams.md

UpdateSubscriptionParams

Fields

Field	Type	Required	Description
customer_id	str	✔️	The ID of the customer to attach the plan to.
entity_id	Optional[str]	➖	The ID of the entity to attach the plan to.
plan_id	str	✔️	The ID of the plan.
feature_quantities	List[models.BillingUpdateFeatureQuantity]	➖	If this plan contains prepaid features, use this field to specify the quantity of each prepaid feature. This quantity includes the included amount and billing units defined when setting up the plan.
version	Optional[float]	➖	The version of the plan to attach.
free_trial	OptionalNullable[models.BillingUpdateFreeTrial]	➖	Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
customize	Optional[models.BillingUpdateCustomize]	➖	Customize the plan to attach. Can either override the price of the plan, the items in the plan, or both.
invoice_mode	Optional[models.BillingUpdateInvoiceMode]	➖	Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
billing_behavior	Optional[models.BillingUpdateBillingBehavior]	➖	How to handle billing when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'next_cycle_only' skips creating any charges and applies the change at the next billing cycle.
cancel_action	Optional[models.BillingUpdateCancelAction]	➖	Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation.