Skip to main content

Create time-based subscriptions

A time-based subscription is a pricing model that charges a consistent, recurring amount for a service. Shopify offers billing intervals for every 30 days and every 365 days.

Merchants must approve the pricing plan. After accepting the charges, the merchant is redirected to a URL that you provide.



Anchor to Step 1: Create the subscriptionStep 1: Create the subscription

  1. Refer to an example of creating an app subscription.

  2. Make a request to the appSubscriptionCreate mutation with the following information:

  3. Use the appRecurringPricingDetails field on the line item's plan to provide the following information:

    • currencyCode

    • price

    • interval

      Note

      The interval field accepts ANNUAL or EVERY_30_DAYS. If not provided, then the default of EVERY_30_DAYS is applied.


Anchor to Step 2: Monitor subscription updatesStep 2: Monitor subscription updates

To receive a notification when a subscription status changes, such as when a charge is successful, subscribe to the GraphQL Admin API's APP_SUBSCRIPTIONS_UPDATE webhook topic.



Was this page helpful?