#Vinz
exotic prism
yep sub_1MqCZHIP6C7BiREFWUmFTpzZ
th subscription status remains unchanged https://stripe.com/docs/billing/subscriptions/pause#unable-provide-services
according to the doc. So How can I get status to "paused"
lusty crow
do you mean on the dashboard or by API?
lusty crow
on Pause the status doesn't change
so basically on the dashboard you will see that the subscription is "Paused" near the "Active" status where as in the API you would need to look at this field https://stripe.com/docs/api/subscriptions/object#subscription_object-pause_collection-behavior and see whether it's not null
exotic prism
OK @lusty crow , so I guess you should remove the "paused" status in the doc https://stripe.com/docs/api/subscriptions/object#subscription_object-status
lusty crow
hmmmm, let me check that
you might be on to something here
because the first line in the description there is
Possible values are incomplete, incomplete_expired, trialing, active, past_due, canceled, or unpaid.
whereas the list has "paused"
arctic fox
sure, it's a typo, thanks for the flag.
we should mention paused in the text description as well.
exotic prism
nope, since it's impossible to get 'paused' as a status
@arctic fox see @lusty crow answers and doc: status won't change on pause collection
arctic fox
k, give me 20 minutes to investigate
the paused status is returned when you're using the brand new feature https://stripe.com/docs/billing/subscriptions/trials#configure-free-trials-without-payment-methods-to-pause to pause a subscription at the end of a trial if no payment method is provided.
ideally it would also apply to subscriptions you pause the other way(the links posted earlier) but it can't as that's a breaking API change(you'd start getting this new status that existing code using Stripe doesn't recognise) so it's not applied retroactively(it's only used if you "opt in" by using that new trial feature).
We'll probably clean this up in a future API version, where we can make the breaking change.
exotic prism
OK thanks @arctic fox I've got an old API version (2020 and I'm afraid to update it don't want to break anything in prod)
arctic fox
there's nothing to update right now at least.
exotic prism
OK, what if I do an update : is the old way to pause subscription compatible with new API ?
arctic fox
there's no update you need to do
there's really no problem here and the way of pausing the subscription using the pause_collection field works, and will work fine
it's just that it doesn't change the subscription status to paused, that is all.
if you want to keep track of if the subscription has been paused that way, the best option is to set some metadata on the Subscription to indicate that to your code.
maybe in future we will release a new API version where the status does change to paused, but you don't need to worry about that.
exotic prism
thank you
worldly copperBOT