Update the maximum charge for a subscription
Update the maximum amount that merchants can be charged for their subscription. You should do this if you change your pricing model.
If you try to create a usage record for a usage pricing plan with an amount that's less than the new usage record, then the request fails. You need to increase the cappedAmount
, and then obtain merchant approval before you can create more usage records.
Anchor to RequirementsRequirements
- Your app can make authenticated requests to the GraphQL Admin API.
Anchor to Step 1: Retrieve charge dataStep 1: Retrieve charge data
Make a request to the AppSubscription
object for the following data:
-
id
-
cappedAmount
The
cappedAmount
is the maximum that a merchant is billed for during the 30-day billing cycle. ThecurrencyCode
must be one of the supported currencies. -
balanceUsed
The following query is an example:
POST https://{shop}.myshopify.com/api/{api_version}/graphql.json
JSON response
Anchor to Step 2: Update the capped amountStep 2: Update the capped amount
Update the app subscription's capped amount by passing the AppSubscription
ID to the appSubscriptionLineItemUpdate
mutation as an argument.
The following mutation is an example: