Report data on app charges and earnings

• You've created a Partner account.
• Your app can make authenticated requests to the GraphQL Admin API.

The app charge overview page allows store owners and staff with the View financials permission to view details about one-time app charges, app usage charges, and app subscriptions in the Partner Dashboard.

If you want to check app charges from a particular merchant store, then you can view details for an app charge from a store's page. If you want to check app charges that are associated with a particular payout, then you can view details for an app charge from the Payouts page. You can also view details for an app charge from the App history page.

Each app charge overview page lists the following details about a particular app charge:

• merchant information, including a link to the store where the app is installed
• the name of the app that the merchant was charged for, including a link to the app
• the status of the app charge or subscription
• a list of merchant payment transactions that are associated with the charge

When you click the arrow that is next to the transaction, the following details for that transaction are displayed:

• an itemized list of the Shopify revenue share fee, the processing fee, and your net profit as the app's developer
• a link to the partner payout that includes the app charge (not available for pending payouts)

If the charge is a recurring app charge or a one-time app charge, then additional details are listed on the overview page.

The app charge overview page for a recurring app charge includes the following details:

• a description of the subscription, such as "$15 every 30 days"
• the subscription creation date
• the status of the recurring app charge, which can be one of the following:
  • Pending: The merchant hasn't yet approved or declined the charge.
  • Accepted: The merchant approved the charge. This is only available for REST API versions older than 2021-01.
  • Activated: The merchant's subscription is currently active.
  • Declined: The merchant declined the charge.
  • Cancelled: The merchant or the developer cancelled the subscription.
  • Frozen: The subscription is on hold due to a store subscription non-payment. The charge reactivates after the subscription payments resume.
  • Expired: The merchant didn't accept the subscription within 2 days.

The app charge overview page for a one-time app charge includes the following details:

• a description of the one-time charge
• the charge creation date
• the status of the recurring app changes, which can be one of the following:
  • Pending: The merchant hasn't yet approved or declined the charge.
  • Accepted: The merchant approved the charge. This is only for REST API versions older than 2021-01.
  • Activated: The merchant's subscription is currently active.
  • Declined: The merchant declined the charge.
  • Expired: The merchant didn’t accept the subscription within 2 days.

1. From your Partner Dashboard, click Apps.
2. In the Partner Dashboard search bar, enter the name of the store with the app charges that you want to check.
3. In the search results, click the name of the store.
4. Next to the app charge that you want to check, click the link in the Details column.

1. From your Partner Dashboard, click Apps.
2. Click Payouts.
3. Click the payout with the app charges that you want to check.
4. Next to the app charge that you want to check, click the link in the Type column.

1. From your Partner Dashboard, click Apps.
2. Click the name of the app with the charges that you want to check.
3. In the sidebar, click Insights > App history.
4. In the table, click the link in the Event details column next to the app charge that you want to check.

You can use the following examples to familiarize yourself with billing data in the GraphQL Admin API.

Using the GraphQL Admin API, you can query for an individual purchase or query for multiple purchases.

To query for a single purchase, you can query the node on AppPurchaseOneTime by passing the app purchase ID as an argument.

To query for multiple purchases, you can use the currentAppInstallation type. You can use the first or last argument to specify how many purchases you want to return.

You can query for an individual subscription or query for multiple subscriptions using the GraphQL Admin API.

To query for a single subscription, you can query the node on AppSubscription by passing the app purchase ID as an argument.

To query for multiple subscriptions, you can use the currentAppInstallation type. You can use the first or last argument to specify how many subscriptions to return.

To query for AppUsageRecords, you can use the currentAppInstallation type. You can obtain the usageRecords from the lineItems field of allSubscriptions. You can use the first or last argument to specify how many records to return.

To query for an AppUsageRecord on a specific subscription, you can query the node on AppSubscription by passing the app subscription ID as an argument.

To query for a specific app usage record, you can query the node on AppUsageRecord by passing the app usage record ID as an argument.

• Learn about supported billing models
• Implement one-time charges
• Implement recurring subscription charges
• Offer free trials of your paid app