---
title: Award app credits
description: Learn how to award app credits to merchants who've installed your app. Credits can be applied to future purchases.
source_url:
  html: https://shopify.dev/docs/apps/launch/billing/award-app-credits
  md: https://shopify.dev/docs/apps/launch/billing/award-app-credits.md
---

ExpandOn this page

* [How it works](https://shopify.dev/docs/apps/launch/billing/award-app-credits#how-it-works)
* [Award app credits using the Partner API](https://shopify.dev/docs/apps/launch/billing/award-app-credits#award-app-credits-using-the-partner-api)
* [Award app credits from the Partner Dashboard](https://shopify.dev/docs/apps/launch/billing/award-app-credits#award-app-credits-from-the-partner-dashboard)
* [Limitations](https://shopify.dev/docs/apps/launch/billing/award-app-credits#limitations)
* [Next steps](https://shopify.dev/docs/apps/launch/billing/award-app-credits#next-steps)

# Award app credits

You can use the [Partner API](#award-app-credits-using-the-partner-api) to give credits to merchants who've installed your app. You can also award app credits using the [Partner Dashboard](#award-app-credits-from-the-partner-dashboard). Merchants can use these app credits to get discounts on future app purchases, monthly subscription fees, and usage charges.

***

## How it works

When you award merchants app credits, the amount is withdrawn from your Partner account based on your revenue share.

There are two scenarios to understand regarding revenue deduction:

* **No revenue deduction**: If the app credit is applied to a pending charge (such as an unpaid invoice), you won't see a deduction from your revenue share.
* **Revenue deduction**: You'll only see a deduction when the app credit amount exceeds any pending charges on the merchant's account.

In other words, Shopify won't deduct from your revenue share for credits that offset amounts the merchant hasn't paid yet.

To use the Partner API, you'll need to implement triggers for the charge, such as when a merchant installs an app, upgrades their service plan, or makes an individual purchase.

***

## Award app credits using the Partner API

To award store credits for your app, you can use the Partner API's [`appCreditCreate`](https://shopify.dev/docs/api/partner/) mutation.

***

## Award app credits from the Partner Dashboard

1. Log in to your [Partner Dashboard](https://www.shopify.com/partners).
2. In the search bar of the Partner Dashboard, enter the name of the store that you want to award app credits to.
3. In the search results, select the store.
4. On the right side of the store page, next to the **App credits** card, click **Send**.
5. On the **App credits** page, select the associated app name.
6. Specify the currency and amount to credit.
7. Optional: Add a note with the reason for awarding credits.
8. Click **Send**.

If the app credit was successfully awarded, a new event displays on the store's page in your Partner Dashboard, and the merchant receiving the app credit can view the sent amount in the **Billing** section of their Shopify admin.

### Required permissions

Owners can issue app credits by default. Staff members can issue app credits if they have the `Manage credits and refunds` permission.

Learn more about [managing staff member permissions](https://help.shopify.com/partners/dashboard/account-access).

***

## Limitations

The total amount of credits can't exceed the total amount of pending payouts in your Partner account.

Note

To view pending payouts, refer to the **Payments** page on your [Partner Dashboard](https://www.shopify.com/partners).

***

## Next steps

[![](https://shopify.dev/images/icons/48/hearts.png)![](https://shopify.dev/images/icons/48/hearts-dark.png)](https://shopify.dev/docs/apps/launch/billing)

[Best practices](https://shopify.dev/docs/apps/launch/billing)

[Learn best practices for app billing.](https://shopify.dev/docs/apps/launch/billing)

***

* [How it works](https://shopify.dev/docs/apps/launch/billing/award-app-credits#how-it-works)
* [Award app credits using the Partner API](https://shopify.dev/docs/apps/launch/billing/award-app-credits#award-app-credits-using-the-partner-api)
* [Award app credits from the Partner Dashboard](https://shopify.dev/docs/apps/launch/billing/award-app-credits#award-app-credits-from-the-partner-dashboard)
* [Limitations](https://shopify.dev/docs/apps/launch/billing/award-app-credits#limitations)
* [Next steps](https://shopify.dev/docs/apps/launch/billing/award-app-credits#next-steps)