Skip to main content
Schema2020-08-27object

subscriptions_resource_pending_update

Pending Updates store the changes pending from a previous update that will be applied to the Subscription upon successful payment.

Source
openapi/spec3.json
Commit
d70de345383d
Active snapshot
da69df7e6e11

SubscriptionsResourcePendingUpdate

object

Pending Updates store the changes pending from a previous update that will be applied to the Subscription upon successful payment.

billing_cycle_anchor integer (unix-time)
optionalnullable

If the update is applied, determines the date of the first full invoice, and, for plans with `month` or `year` intervals, the day of the month for subsequent invoices.

expires_at integer (unix-time)
required

The point after which the changes reflected by this update will be discarded and no longer applied.

subscription_items array
optionalnullable

List of subscription items, each with an attached plan, that will be set if the update is applied.

trial_end integer (unix-time)
optionalnullable

Unix timestamp representing the end of the trial period the customer will get before being charged for the first time, if the update is applied.

trial_from_plan boolean
optionalnullable

Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more.