You can create discounts for both potential and existing customers through the Developer Center or API. Once the discount is created:

• For potential customers, the discounted price is shown during checkout when they select the discounted plan.
• For existing customers, the discount is applied automatically at the next billing cycle or when they switch to a discounted plan.

Developer Center

1. Open your app in the Developer Center.
2. Click Monetization in the left-side menu.
3. On the Monetization page, select the Discounts tab to view your discounts.
4. Click Grant a new discount in the top-right corner.
5. Enter the Account slug (found in your webhooks or by querying the account through the API).

At this point, the system checks whether the account has an active subscription to your app:

• If no active subscription exists, you will see a message indicating that none exists.
• If an active subscription exists, it will appear in the Active plan section, including the plan name, subscription status, billing frequency, and next billing cycle.

6. Select the specific plan to apply the discount to, or select All plans.
   • For accounts with an active subscription, you can apply the discount to either the current plan or a different plan. The discount does not have to be applied to the existing plan.
7. Specify whether the discount applies to a monthly or yearly subscription. If you’re unsure which option the customer will choose, select both.
8. Enter the discount percentage.
9. Enter the number of days the discount applies for. During this period, potential customers can claim the discount, and existing customers will receive the discounted price. After the validity period ends, the discount will no longer be available to potential customers and will be removed from existing subscriptions.
10. Click Grant discount.

API

To create a discount via the API, use the create_marketplace_app_discount mutation.

mutation {
  create_marketplace_app_discount(
    app_id: "12345"
    account_slug: "my-company"
    discount_data: {
      discount: 20
      days_valid: 30
      period: MONTHLY
      app_plan_ids: ["plan_001"]
    }
  ) {
    granted_discount {
      app_id
      app_plan_ids
      discount
      period
    }
  }
}

Troubleshooting

If you receive an error while attempting to grant a discount, refer to the table below for common issues: