Shopify app billing subscription flow(Manual Pricing)

Hi Community,

I’m using Shopify’s App Subscription API to subscriptions for my app.

I retrieved the subscription details and received the following response:
{
“status”: “SUCCESS”,
“subscriptionDetails”: {
“id”: “gid://shopify/AppSubscription/65414988089”,
“name”: “SF_Billing_Starter”,
“status”: “ACTIVE”,
“createdAt”: “2026-09-11T20:21:38Z”,
“currentPeriodEnd”: “2026-10-11T20:21:47Z”,
“trialDays”: 0,
“test”: true
},
“message”: “Subscription details retrieved successfully”
}

The currentPeriodEnd date is October 11, 2026, which has already passed, but the subscription status is still ACTIVE, and the currentPeriodEnd value has not moved to the next billing period.

Could you please help on the following?

  1. Does this behavior differ for test subscriptions (test: true) compared with live subscriptions?

  2. How can I test the complete recurring billing flow with test: false? Does Shopify provide a test card or another testing mechanism for live-like subscriptions? Can we simulate or skip the billing period dates to test subscription renewal, payment success, payment failure, and subscription status changes without waiting 30 days for the next billing cycle?

I want to verify the recurring billing lifecycle before releasing the app to production. Waiting for an entire billing period for each test would make this process difficult.

  1. Yes, test subscriptions behave differently. A test charge is never actually billed, so nothing advances currentPeriodEnd. Seeing ACTIVE with a past date is expected when test: true. On live subscriptions the date moves forward each billing cycle.
  2. There’s no test card for app billing. A development store can only approve test: true charges, and real charges only happen on a live merchant store. You can’t skip ahead in time either, so test the lifecycle through webhooks:
  • Subscribe to APP_SUBSCRIPTIONS_UPDATE and let it drive your app’s billing state, not currentPeriodEnd.
  • Replay each status with shopify app webhook trigger --topic app_subscriptions/update, editing the payload for ACTIVE, FROZEN, CANCELLED and DECLINED.
  • Test cancel, re-subscribe and upgrade flows on the dev store.
  • Check access by status. A failed payment shows up as FROZEN, so lock paid features on that status.

Hey @amber_dube as Rashid mentioned, test charges do behave differently as no actual billing record is created. Due to that you won’t be able to test the full recurring cycle, only the initial mutations you make.

I am curious though, since it sounds like a newer integration. Is there a feature missing from app pricing that blocks you from using it?

Thanks @Rashid_Ali and @KyleG-Shopify for the clarification!

I have two follow-up questions:

  1. For live subscriptions (test: false), when a subscription is in its trial period, will we receive an APP_SUBSCRIPTIONS_UPDATE webhook when the trial ends and the actual billing period begins? Similarly, will the same webhook be triggered on every successful or failed renewal?

    I’m asking because, with test subscriptions, I don’t receive this webhook when the trial period ends or when currentPeriodEnd passes. I want to confirm the expected webhook behavior for live subscriptions so we can handle these transitions correctly.

  2. Regarding managed app pricing, I actually didn’t see an option to choose managed app pricing or manual billing when creating my app in the Shopify Dev Dashboard. That’s why I went with the Billing API and manual pricing.

Thanks again!

ran into this on one of our apps too. what fixed it for us:

  • check the active plan with currentAppInstallation.activeSubscriptions
  • treat shop.plan.partnerDevelopment stores as “free/dev” so reviewers aren’t blocked
  • send “Choose plan” to Shopify’s hosted pricing page instead of creating a charge with the Billing API

hope that helps!

Hey @amber_dube APP_SUBSCRIPTIONS_UPDATE fires on a status change (or a capped amount update), not on period rollovers so I wouldn’t rely on it to catch trial ends

To catch trial end and successful renewals, re-query the subscription once currentPeriodEnd passes.

Managed pricing is currently managed on the app store listing settings in the Partner Dashboard which is why you didn’t see it in the dev dashboard.