Benoît | Stripe Developers | Page 1

regal spokeBOT Jul 28, 2023, 4:14 PM

#

cyan latch Jul 28, 2023, 4:14 PM

#

Hi 👋

Can you share the API request ID that is throwing the error?

Here's how you can find a request ID: https://support.stripe.com/questions/finding-the-id-for-an-api-request

odd adder Jul 28, 2023, 4:15 PM

#

Hi ! I don't have a request ID yet, that's my IDE that throw me the error

#

#

Maybe that's only a problem on my IDE ? I loaded the Stripe NPM package v12.10.0

cyan latch Jul 28, 2023, 4:19 PM

#

Oh this looks like a TypeScript error

#

What is the type expected here?

odd adder Jul 28, 2023, 4:21 PM

#

"now" or "unchanged"

#

That's what i see in the docs : https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_cycle_anchor

cyan latch Jul 28, 2023, 4:22 PM

#

But if you are using stripe-node in TypeScript you have to understand the types

#

You can review them here: https://github.com/stripe/stripe-node/tree/master/types

odd adder Jul 28, 2023, 4:23 PM

#

"now" or "unchanged" are strings

#

I'm not sure to understand your question

#

I call subscriptions.update()

cyan latch Jul 28, 2023, 4:25 PM

#

The error message tells you what to look at

#

The expected type comes from the property billing_cycle_anchor in type SubscriptionUpdateParams

odd adder Jul 28, 2023, 4:26 PM

#

Yes, and i looked. I tried a timestamp because one of your colleague suggested me to do so

odd adder Jul 28, 2023, 4:26 PM

#

cyan latch The expected type comes from the property `billing_cycle_anchor` in type Subscri...

Yes, what do you want to tell me ?

#

Sorry, i'm french, sometimes i don't understand all

cyan latch Jul 28, 2023, 4:28 PM

#

I'm saying you need to look here: https://github.com/stripe/stripe-node/blob/master/types/SubscriptionsResource.d.ts#L687C67-L687C67 to determine the correct Type to cast the value to.

odd adder Jul 28, 2023, 4:33 PM

#

I looked, that's the same thing that in the docs https://stripe.com/docs/api/subscriptions/update#update_subscription-billing_cycle_anchor

It says i must use "now" or "unchanged". But one of your colleague toldme yesterday to try with a timestamp

cyan latch Jul 28, 2023, 4:36 PM

#

And that is causing a type error

odd adder Jul 28, 2023, 4:37 PM

#

Yes, that's why i asked the question in the general chan, "In the docs, i can see that a timestamp is not possible, so i don't know how to do what i'm searching for"

#

I'm searching for a way to update the billing cycle of my subscription, and set it whenever i want

cyan latch Jul 28, 2023, 4:53 PM

#

Okay I get what you are looking for. Let me do some digging

odd adder Jul 28, 2023, 4:54 PM

#

Let's imagine my customer subscribe to a plan on august 1st, and decide to pause it on august 10th. Some months later, my customer decide to reactivate his subscription on december 25th, so i need to reset his billing cycle date to (december 25th + 20 unused days) = january 14th

#

Thanks !

cyan latch Jul 28, 2023, 4:56 PM

#

Okay, confirmed that you can only set the biling cycle anchor to a specific date when you create a Subscription, not when you resume a Subscription

odd adder Jul 28, 2023, 4:57 PM

#

arf

odd adder Jul 28, 2023, 4:58 PM

#

odd adder Let's imagine my customer subscribe to a plan on august 1st, and decide to pause...

From this example, what would happen to the billing cycle if i just resume the Subscription with pause_collection: '' ?

#

Would the next invoice happen on january 1st ?

cyan latch Jul 28, 2023, 5:01 PM

#

I'm looking but we don't call out what the default value is (if not provided)

odd adder Jul 28, 2023, 5:05 PM

#

ok

#

thank you

cyan latch Jul 28, 2023, 5:05 PM

#

I would recommend testing this out to ensure you get the behavior you expect

regal spokeBOT Jul 28, 2023, 5:17 PM

#

odd adder Jul 28, 2023, 5:20 PM

#

I tried with a subscription that started july 27th. When i pause it today and resume it after, that's like i didn't do anything. The next invoice still remains at august 27th

quaint ocean Jul 28, 2023, 5:21 PM

#

Hello! Hopping in here since snufkin has to head out soon

odd adder Jul 28, 2023, 5:21 PM

#

Hello, NP !

quaint ocean Jul 28, 2023, 5:22 PM

#

You're using pause_collection right? pause_collection doesn't have any affect on the billing cycle at all - invoices are still generated normally, we just change what we do with them (automatically void them, keep them as draft, etc.)

odd adder Jul 28, 2023, 5:25 PM

#

Ok.
I don't know if you read our previous messages, so just in case : Let's imagine my customer subscribe to a plan on august 1st, and decide to pause it on august 10th. My customer decide to resume his subscription on december 25th, so i need to reset his billing cycle date to (december 25th + 20 unused days) = january 14th

That was my problem
And i also wonder what would be the next invoice date after my customer resume his subscription just with the pause_collection: '' param. Will it be the january 1st ?

quaint ocean Jul 28, 2023, 5:37 PM

#

Yeah the issue is that right now, this is not what pause_collection is meant to be used for - it doesn't do any kind of prorations when you turn it on/off. So what you'd need to do is reset the billing cycle anchor yourself on the 14th

#

and yes, the next invoice date after you resume would be jan 1st if you don't reset the anchor yourself

odd adder Jul 28, 2023, 5:38 PM

#

I'd love to do be able to reset the billing cycle anchor myslef on the 14th, but it would be great to be able to define it now for a future date, as i have no possibility to do the action myslef on january 14th with the billing_cycle_anchor: 'now' param

quaint ocean Jul 28, 2023, 5:45 PM

#

Yeah... what you could do is try using a subscription schedule to do this for you

#

Let me try and think through what combination of phases would work for this

odd adder Jul 28, 2023, 5:47 PM

#

I was thinking about it, but i wondered what would happened if the customer resume the subscription on december 25th, and decide to finaly cancel it on december 27th for example ? Will the schedule be canceled too ?

quaint ocean Jul 28, 2023, 5:47 PM

#

Yeah if the subcription is cancelled this would cancel the underlying schedule as well

odd adder Jul 28, 2023, 5:47 PM

#

Ah, that would be great !

quaint ocean Jul 28, 2023, 5:54 PM

#

Thinking out loud, I think you could make somethign like this work:

You have the subscritoin that was paused on august 10th
When the customer resumes on december 25th you calculate when you want the next billing cycle date to be and set pause_collection.resumed_at (https://stripe.com/docs/api/subscriptions/update#update_subscription-pause_collection-resumes_at) to be that date (Jan 14th)
I believe when Jan 14th rolls around you should get a customer.subscription.updated webhook event and you can see if pause_collection was changed. If it was, you can reset the billing cycle anchor immediately

Stripe API reference – Update a subscription – curl

Complete reference documentation for the Stripe API. Includes code snippets and examples for our Python, Java, PHP, Node.js, Go, Ruby, and .NET libraries.

#

You'd want to test that out fully to make sure it works, but it avoids the need for subscription schedules (which can get a bit complicated)

odd adder Jul 28, 2023, 5:56 PM

#

The idea is good, but how could i see if pause_collection was changed in the webhook payload ?

#

Where could i retrieve the previous state ?

quaint ocean Jul 28, 2023, 5:58 PM

#

With *.updated event types we set data.previous_attributes on the event (https://stripe.com/docs/api/events/object#event_object-data-previous_attributes) so that you can compare what was previously vs currently set on the event

odd adder Jul 28, 2023, 5:59 PM

#

Great, i will test this now (i already have this webhook ready to be triggered)

#

Would you let this PM opened for me to tell you if it worked or not ?

quaint ocean Jul 28, 2023, 6:00 PM

#

you can let us know here if it works 🙂

odd adder Jul 28, 2023, 6:02 PM

#

Ok. i'm studying my webhook event to check the previous state (we_1HjPaMAYYvne95SHn0XQBg6E)

#

Could you tell me what is the type of the webhook event payload please ? I currently use the Subscription object from the payload (from payload.data.object), but i need to target payload.data for the previous attributes

#

Maybe i'm not clear. From the payload object (on screenshot), what is the Stripe type of payload.data please

quaint ocean Jul 28, 2023, 6:14 PM

#

payout.datais a hash that has a payload.data.object (which is the Subscription object you want) and payout.data.previous_attributes if the event is for an update

odd adder Jul 28, 2023, 6:15 PM

#

Yes, i just would like to know the type of payload.data.
For example, payload.data.object is a type of Stripe.Subscription

#

I need to type my objects

#

I use this NodeJS package : https://www.npmjs.com/package/stripe

#

Does payout.data as a specific Stripe type, like payload.data.object ?

quaint ocean Jul 28, 2023, 6:19 PM

#

Have you taken a look at https://github.com/stripe/stripe-node/blob/f646c9d91eab4a80e59cfd1de966b7bdca5926c9/types/Events.d.ts#L62C13-L62C23

#

that's our typescript definition for Event in our node library

odd adder Jul 28, 2023, 6:20 PM

#

Ah great ! That's what i looked for !

#

Stripe.Event.Data.PreviousAttributes seems to be an untyped object, is that right ?

#

I try to autocomplete my object, but there's no object properties to be found

quaint ocean Jul 28, 2023, 6:30 PM

#

Yeah that one's just an empty interface https://github.com/stripe/stripe-node/blob/f646c9d91eab4a80e59cfd1de966b7bdca5926c9/types/Events.d.ts#L101

#

I'm assuming it's because we can't really logically give it all the object properties for every single resource that would be updated

odd adder Jul 28, 2023, 6:31 PM

#

ok

#Benoît