Subscription Behavior After Re-installation & Trial → Paid Transition

[KyleG-Shopify]

Hey @MovoLabs,

I recently answered a very similar question here: App subscription behaviour + upgrade/downgrade after app reinstall I’d recommend reading that over as well as there’s some other useful context discussed!

To answer your questions though, for your reinstall scenario:

@MovoLabs

Are we required to request a new subscription approval immediately on reinstall, even if the merchant had time remaining?

You’re not required to request immediate approval if there’s time remaining in the previously paid period since the merchant has already paid for that time. The best practice is still to redirect them to your billing page on reinstall so they can select a plan to ensure billing continues after their original period expires.

@MovoLabs

What happens to the remaining paid days? Does the new subscription start after those days end, or is that time lost?

The remaining paid time isn’t lost. You can control when the new subscription starts using AppSubscriptionReplacementBehavior. You have options like APPLY_ON_NEXT_BILLING_CYCLE to defer the new plan until the current period ends, or APPLY_IMMEDIATELY for immediate changes with proration.

@MovoLabs

If the merchant declines the new subscription approval, are we allowed to continue offering paid features until their original currentPeriodEnd?

You can and should continue offering paid features until the original currentPeriodEnd expires since they’ve already paid for that period.

For your trial questions:

@MovoLabs

Is there any webhook triggered when the trial transitions into a paid billing cycle?

Yes - subscribe to the APP_SUBSCRIPTIONS_UPDATE webhook topic. This is the method recommended in our time-based subscription documentation for monitoring subscription status changes.

Hope that helps!