#sabrina_best-practices

1 messages ¡ Page 1 of 1 (latest)

bronze spadeBOT
#

👋 Welcome to your new thread!

⏲️ We'll be here soon! We typically respond in a few minutes, but in some cases we might need a bit more time (e.g., server's busy, you've got a complex question, etc.).

⏱️ We close idle threads, which makes them read-only. Once a thread is closed it won't be reopened, but you can start a new thread if you have another question.

🔗 This thread will always be available, even after it's closed. You can find it again using Discord's search, or you can save this link: https://discord.com/channels/841573134531821608/1257501664538136656

📝 Have more to share? Add details, code, screenshots, videos, etc. below.

halcyon goblet
#

Here is an example of the flow:

  1. Customer purchases annual subscription on January 1st, 2024. Subscription end date is January 1, 2025
  2. The subscription is paused on January 1st, 2024
  3. On April 1st, the subscription is unpaused.
  4. At this point we'd like to change the subscription end date to April 1st 2025. This would ensure the user receives 12 full months of an active subscription. We do not want to bill the customer or use trialing <---- How can we do this??
slow basin
#

Thanks for waiting! Could you share the subscription (sub_xxx) that you have attempted to change the billing cycle, but was prorated, so that I can understand how your integration works at the moment?

halcyon goblet
#

sub_1PQrv4Jaf89hC41I1wKcbyDG

#

sub_1PWXmuJaf89hC41IWO9EXZhX

#

This is a new feature so examples are only available in test mode.

#

Here is a summary of what we were trying with these subscriptions:

  1. Create Subscription Normally: Ensures the subscription is created and paid for upfront.
  2. Pause Subscription: Prevents the subscription from starting until the user is ready.
  3. Resume Subscription: Activates the subscription when the user is ready to start using the service.
  4. Extend the Subscription Period: Adds a negative invoice item to adjust the billing period without changing the billing_cycle_anchor.
boreal nicheBOT
latent elk
#

Hi @halcyon goblet I'm taking over this thread, give me a sec to catch up.

#

Can you tell me how you paused these subscriptions?

halcyon goblet
#

Here is an example of a subscription that is currently paused. We have not tried to unpause it and adjust the subscription end date yet: sub_1PXeUiJaf89hC41I3wH45Nq2

latent elk
#

Ok, I can see that this subscription is currently paused. So you question is how to automatically cancel this subscription after 12 billing cycles?

halcyon goblet
#

No, my question is related to the paused period. If the subscription stays paused for 3 months and is then unpaused, how can we add back the 3 month paused period to the subscription so that customer has 12 full months of active subscriotion.

#

Ideally, after unpausing the subscription the subscription end date would be extended to account for the paused period.

latent elk
#

What do you mean by "dd back the 3 month paused period "?

#

And what do you mean by "end date to be extended" ?

#

I dont' see this subscription has a schedule attached to it.

halcyon goblet
#

Does this example of the desired flow help?

  1. Customer purchases annual subscription on January 1st, 2024. Subscription end date is January 1, 2025
  2. The subscription is paused on January 1st, 2024
  3. On April 1st, the subscription is unpaused.
  4. At this point we'd like to change the subscription end date to April 1st 2025. This would ensure the user receives 12 full months of an active subscription. We do not want to bill the customer or use trialing
latent elk
#

Ok, here's the thing

halcyon goblet
latent elk
#

The subscription is an anual subscription, which means it only generate invoice once a year.

#

So the first invoice is generated on 1st Jan 2024 when your custom subscribed it, and the second invoice will be generated on 1st Jan 2025.

#

When you pause the subscription on 1st April 2024, it doesn't really have an impact to this subscription because there's no new invoices generated in that month.

halcyon goblet
#

Yes, understood. But how can we change the next invoice date? In my example, we'd like to change the next invoice date and all future renewal dates from January 1st to April 1st.

latent elk
halcyon goblet
#

Will this result in the customer being billed at the time we change the billing cycle anchor?

latent elk
#

No, the customer will only be billed at the time of change if you set proration_behavior to always_invoice.

#

And I think you want to set proration_behavior to none to disable proration

halcyon goblet
#

Can I Reset the billing cycle anchor to the current time and set proration = none?

#

Did I lose you?

slow basin
#

Do you plan to reset the billing cycle anchor to current or future timestamp?

halcyon goblet
#

It could be current. For example, if I unpause the subscription today, I would want the next invoice date to be July 1st, 2025.

slow basin
#

If this is the case, then

Can I Reset the billing cycle anchor to the current time and set proration = none?
Yes! This is correct. The next billing cycle will be July 1st, 2025 without proration

halcyon goblet
#

Would the invoice on January 25th 2025 be for the full price of the subscription ($299 in this case) or more? I am concerned that Stripe will recognize an unpaid period when we change the billing date and add this to the next invoice.

slow basin
#

Changing the billing cycle anchor will change the next billing date. If the billing cycle anchor is updated to now, the next invoice will be on July 1st 2025 instead of Jan 25th at the full price

halcyon goblet
#

Yes, I understand that but how will the invoice amount be calculated?

slow basin
#

With proration_behavior: 'none', the invoice amount will not have any proration. If the full price of the subscription is $299, the invoice will be $299 in the next billing cycle on July 1st, 2025

halcyon goblet
#

What if the subscription was originally started on January 1st 2024. If I set 'billing_cycle_anchor' => 'now' on today, July 1st, would the next invoice will be only $299 on July 1 2025?

slow basin
#

By setting proration_behavior: 'none' and billing_cycle_anchor: 'now', it will create a new full price invoice now. For example,

  1. Subscription created on Jan 1, 2024 - customer will be charged at $299
  2. Subscription changed the billing cycle anchor to Jun 1, 2024 when setting proration_behavior: 'none' and billing_cycle_anchor: 'now' - customer will be charged at $299
  3. Next billing cycle will be on Jun 1, 2025 - customer will be charged at $299

At step 2, it will overcharge since a full price invoice is created. The only way to not charge at Step 2 is by using the trial period: https://docs.stripe.com/billing/subscriptions/billing-cycle#add-a-trial-to-change-the-billing-cycle

Setting the subscription billing cycle date

Learn how to set the billing date for subscriptions.

halcyon goblet
#

How will the trial period impact our MRR metrics in Stripe?

slow basin
#

This channel is for technical integration questions such as API. I'm afraid we are unfamiliar how the trial period will affect the MRR metrics

#

I'd recommend checking with Support https://support.stripe.com/contact how the trial will affect the MRR metrics

Stripe: Help & Support

Find help and support for Stripe. Our support site provides answers on all types of situations, including account information, charges and refunds, and subscriptions information. Get your questions answered and find international support for Stripe.

halcyon goblet
#

Thank you