View charges and earnings

You can view the following data by page in the Partner Dashboard:

The app charge overview page provides the most comprehensive information regarding charges and earnings. The page provides the following details:

• 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

• The list of merchant payment transactions that are associated with the charge

Clicking the arrow next to a transaction displays the following details:

• An itemized list of the Shopify revenue share fee, processing fee, and your net profit as the app's developer

• A link to the Partner payout that includes the app charge. The payout link isn't applicable to pending payouts.

The overview page includes additional charge details for subscription charges.

You can view the following additional details for subscription charges:

• A description of the charge, such as $15 every 30 days for an app subscription charge.

• The date on which the charge was created.

• The charge's status, which can be one of the following:

  Charge statuses

  Status	Description
  Pending	The merchant hasn't yet approved or declined the charge.
  Activated	The charge is currently active. For some payments, such as wire transfers, Shopify marks the charge as active when the payment is in flight.
  Declined	The merchant declined the charge.
  Canceled	The merchant or the developer canceled the subscription If a payment doesn't go through, then Shopify retries the charge. Only shut off a merchant's app access after Shopify freezes the charge.
  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 charge within two non-business days.

You can use the following billing resources on the GraphQL Admin API to view transaction data:

You can view your app's revenue and retrieve data on transactions using the following mechanisms:

• Partner Dashboard

• GraphQL Admin API

• To use the Partner Dashboard, you require a Partner account.

• To view the Partner Dashboard's app charge overview and Payouts pages, store owners and staff require the View financials permission.

• To use the GraphQL Admin API, your app must be able to make authenticated requests to the API.

The following procedures explain how to view app charges and data from the Partner Dashboard:

1. From the Partner Dashboard, click Apps .
2. Select the app that you want to view charges for.
3. On the Overview page, scroll to Latest app history.
4. Optional: Select View all app history and navigate through the pages.
5. In the Event Details column, click Open payments.
6. To view transaction details, next to a transaction click the inverted caret (▼).

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

1. From the Partner Dashboard, click Apps .
2. In the sidebar, click Payouts.
3. On the Payouts page, 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.
5. For details, next to a transaction click the inverted caret.

1. From the 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 next to the app charge that you want to check, in the Event Details column, click Open payments.
5. For details, next to a transaction click the inverted caret.

Use the following examples to familiarize yourself with billing data in the GraphQL Admin API. The currency code must be one of the supported currencies.

You can query a single purchase or multiple purchases.

Query a single purchase with the AppPurchaseOneTime object. Pass the app purchase ID as an argument. You can retrieve this ID from the Payouts page.

The following is an example:

Query multiple purchases using currentAppInstallation. Specify the number of purchases to return by passing first or last as an argument.

The following is an example:

You can query a single subscription or multiple subscriptions.

Query a single subscription using the AppSubscription object. Pass the subscription ID as an argument.

The subscription ID is returned when you create a subscription. The AppSubscription object can also return the app subscriptions that are associated with the installation.

The following is an example:

Query multiple subscriptions using currentAppInstallation. Specify the number of subscriptions to return by passing first or last as an argument.

The following is an example:

Query an app usage record for a single subscription or records for multiple subscriptions. You can also query a specific app usage record by its ID.

Query the app usage record for a single subscription using the AppSubscription object. Pass the subscription ID as an argument. You can specify the number of records to return by passing first or last as an argument.

The subscription ID is returned when you create a subscription. The AppSubscription object can also return the app subscriptions that are associated with the installation.

The following is an example:

Query the app usage record for a single subscription using currentAppInstallation. You can get the usageRecords from the lineItems field of allSubscriptions. Specify the number of records to return by passing first or last as an argument.

Query a specific app usage record using the AppUsageRecord object. Pass the app usage record ID as an argument.