AppSubscription

The app the subscription is generating charges for.

The date and time when the app subscription was created.

The date and time when the current app subscription period ends. Returns null if the subscription isn't active.

A globally-unique ID.

The plans attached to the app subscription.

The name of the app subscription.

The URL that the merchant is redirected to after approving the app subscription.

The status of the app subscription.

Specifies whether the app subscription is a test transaction.

The number of free trial days, starting at the subscription's creation date, by which billing is delayed.

Cancels an active app subscription, stopping future billing cycles. The cancellation behavior depends on the replacementBehavior setting - it can either disable auto-renewal (allowing the subscription to continue until the end of the current billing period) or immediately cancel with prorated refunds.

When a merchant decides to discontinue using subscription features, this mutation provides a clean cancellation workflow that respects billing periods and merchant expectations.

Use the AppSubscriptionCancel mutation to:

• Process merchant-initiated subscription cancellations
• Terminate subscriptions due to policy violations or account issues
• Handle subscription cancellations during app uninstallation workflows

The cancellation timing and merchant access depends on the replacementBehavior setting and the app's specific implementation of subscription management.

For subscription lifecycle management and cancellation best practices, consult the subscription management guide.

Allows an app to charge a store for features or services on a recurring basis.

Updates the capped amount on the usage pricing plan of an app subscription line item.

Extends the trial period for an existing app subscription, giving merchants additional time to evaluate premium features before committing to paid billing. This mutation provides flexibility in trial management and can improve conversion rates by accommodating merchant needs.

Trial extensions are particularly valuable when merchants need more time to fully evaluate complex features, experience technical setup delays, or require additional approval processes within their organization before committing to paid subscriptions.

Use the AppSubscriptionTrialExtend mutation to:

• Accommodate merchant requests for additional evaluation time
• Compensate for service interruptions during trial periods
• Support complex enterprise evaluation and approval workflows
• Implement customer success strategies that improve trial-to-paid conversion
• Handle technical onboarding delays that impact trial effectiveness

The extension modifies the existing trial end date, allowing continued access to subscription features without immediate billing. This approach maintains subscription continuity while providing merchants the flexibility they need for thorough feature evaluation.

Trial extension strategies and conversion techniques are covered in the offer free trials guide.