---
title: Update the maximum charge for a subscription
description: >-
  Learn how to update the maximum amount that merchants can be charged for each
  purchase.
source_url:
  html: >-
    https://shopify.dev/docs/apps/launch/billing/manual-pricing/subscription-billing/update-max-charge
  md: >-
    https://shopify.dev/docs/apps/launch/billing/manual-pricing/subscription-billing/update-max-charge.md
---

# Update the maximum charge for a subscription

**Preferred approach:**

For public apps, use [Shopify App Pricing](https://shopify.dev/docs/apps/launch/billing/shopify-app-pricing). The Billing API is still supported for existing apps and outlier pricing models Shopify App Pricing doesn't cover.

Update the maximum amount that merchants can be charged for their subscription. You should do this if you change your pricing model.

**Note:**

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.

***

## Requirements

* Your app can make [authenticated requests](https://shopify.dev/docs/api/admin-graphql#authentication) to the GraphQL Admin API.

***

## Step 1: Retrieve charge data

Make a request to the [`AppSubscription`](https://shopify.dev/docs/api/admin-graphql/latest/objects/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. The `currencyCode` must be one of the [supported currencies](https://shopify.dev/docs/apps/launch/billing#supported-currencies).

* `balanceUsed`

  The following query is an example:

## POST https://{shop}.myshopify.com/api/{api\_version}/graphql.json

## JSON response

```json
{
  "data": {
    "node": {
      "lineItems": [
        {
          "plan": {
            "pricingDetails": {
              "terms": "$1 for 100 emails",
              "cappedAmount": {
                "amount": "20.0",
                "currencyCode": "USD"
              },
              "balanceUsed": {
                "amount": "0.0",
                "currencyCode": "USD"
              }
            }
          }
        }
      ]
    }
  },
  ...
}
```

***

## Step 2: Update the capped amount

Update the app subscription's capped amount by passing the `AppSubscription` ID to the [`appSubscriptionLineItemUpdate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionLineItemUpdate) mutation as an argument.

The following mutation is an example:

## POST https://{shop}.myshopify.com/api/{api\_version}/graphql.json

## JSON response

```json
{
  "data": {
    "appSubscriptionLineItemUpdate": {
      "userErrors": [],
      "confirmationUrl": "https://domain.myshopify.com/admin/charges/4019585080/confirm_update_capped_amount?signature=BAh7BzoHaWRsKwc4AJbvOhJhdXRvX2FjdGl2YXRlRg%3D%3D--a93b35054feb213f04f1ee35ef5b569617ce6823",
      "appSubscription": {
        "id": "gid://shopify/AppSubscription/4019585080"
      }
    }
  },
  ...
}
```

***

## Next steps

[Discounts\
\
](https://shopify.dev/docs/apps/launch/billing/subscription-billing/offer-subscription-discounts)

[Learn about offering subscription discounts.](https://shopify.dev/docs/apps/launch/billing/subscription-billing/offer-subscription-discounts)

***