Developer Console

Set Up Promotional Pricing

Promotional pricing provides you with a way to offer discounted prices for customers who purchase subscription in-app purchases (IAP). You can choose to target only lapsed customers who are resubscribing, or you can target both new and lapsed customers. You can configure promotional pricing on the Developer Console. To get started with promotional pricing, watch the video tutorial.

For more details on how to set up promotional pricing, follow the instructions on this page.

Promotional pricing terms

A promotional pricing offer is only applicable once per subscription product across all terms of that subscription IAP. You can extend promotional offers to customers under one of the following terms:

  • One time upfront discounted price for a period of n terms. The term can be different from the regular subscription term. For example, if a subscription regularly costs $9.99 per month, you can offer a one time discounted price of $19.99 for the first three months. See One time price durations for valid term values.
  • Recurring discounted payment for up to n terms. The term must be the same as the regular subscription term. For example, if a subscription regularly costs $9.99 per month, you can offer a recurring discount of $6.99 per month for the first three months.

For either offer, the customer defaults to the regular subscription IAP price after the promotional pricing term expires.

Promotional pricing customer segments

Promotional pricing also allows you to target a particular customer segment. Customer segments are classified as follows:

  • All customers. Includes new subscribing customers, and resubscribing customers who haven't previously enjoyed a promotion.
  • Lapsed customers. Includes only resubscribing customers. To be eligible for the promotion, a lapsed customer must not have had an active subscription to this product for a minimum period of time. You must configure a minimum lapsed period.

Set up promotional pricing

Follow these steps to set up promotional pricing:

  1. Open your app in the Developer Console.
  2. Navigate to Subscription terms. Select the Subscription period, SKU, and paid status.
  3. Select a free trial status. If you offer a free trial, the promotional pricing takes effect after the free trial ends.
  4. Select Yes for promotional pricing and make selections in the available fields, shown below, to customize your offer.

    Promotional pricing fields in the Developer Console
    Promotional pricing fields in the Developer Console
  5. Complete the terms, pricing, customer targeting, and dates for your promotional price. The date fields use the UTC time zone.

One time promotional pricing

To set up a one time upfront discounted price:

  1. In the How would you like to charge? field, select One time charge.
  2. In Duration of promotional price, select the duration of the one time charge. See One time price durations for possible values.

    Duration of promotional price field for one time charge
  3. Select Set pricing.
  4. In the Set subscription pricing field, enter your promotional price and the regular subscription price after the promotional period ends. Choose if you would like Amazon to calculate the price for other marketplaces or if you would like to manually enter them. Click Save.

    Set subscription pricing field for one time charge
  5. Click Submit IAP to finalize the promotional pricing.

Recurring promotional pricing

To set up a recurring discounted price:

  1. In the How would you like to charge? field, select Recurring charge.
  2. Select the duration of each recurring charge. You can add and remove charges. See Recurring price durations for possible values.

    Duration of promotional prices field for recurring charge
  3. Select Set pricing.
  4. In the Set subscription pricing field, enter each recurring charge and the regular subscription price after the promotional periods end. Choose if you would like Amazon to calculate the price for other marketplaces or if you would like to manually enter them. Click Save.

    Set subscription pricing field for recurring charge
  5. Click Submit IAP to finalize the promotional pricing.

Promotional pricing durations

The durations for recurring promotional pricing and one time promotional pricing have different possible values.

Recurring price durations

The duration of a recurring promotional price can have the following values:

  • Weekly — 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 weeks
  • BiWeekly — 2, 4, 6, 8, 10, or 12 weeks
  • Monthly — 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, or 12 months
  • BiMonthly — 2, 4, 6, 8, 10, or 12 months
  • Quarterly — 3, 6, 9, or 12 months
  • SemiAnnually — 6 or 12 months
  • Annually — 1 year

One time price durations

The duration of a one time promotional price can have the following values:

  • 7 Days
  • 14 Days
  • 1 Month
  • 2 Months
  • 3 Months
  • 6 Months
  • 1 Year

Targeted promotion for all customers

To set up a targeted promotion for all customers:

  1. All customers is selected by default, leave this selected.
  2. Set up the start and end date for the promotion to be available to customers. The start date must be in the future. Dates use the UTC time zone.
    Set start and end date for all customers

Targeted promotion for lapsed customers

To set up a targeted promotion for lapsed customers:

  1. Select Lapsed customers.
  2. To be eligible for the promotion, a lapsed customer must not have had an active subscription to this product for a minimum period of time. Choose a duration to indicate this time period.
  3. Set up the start and end date for the promotion to be available to customers. The start date must be in the future. Dates use the UTC time zone.
    Set lapsed duration and start and end date for lapsed customers

Change promotional prices

You can change the promotional prices or terms at any time in the Developer Console. Any change is available only for customers that sign up after the change. See Create and Submit Single IAP Items to learn more about changing IAP prices.

Appstore SDK and Receipt Verification Service

When setting up promotional pricing, you can programmatically check the availability of your promotion plans with the Appstore SDK and the status of your customers' promotions with the Receipt Verification Service (RVS).

To learn how to integrate the Appstore SDK with your app, see Implement the Android IAP API. Using the getProductData method, you can check if a customer is eligible for promotions and get promotion details. For more details, see Implement getProductData method.

To learn how to use RVS with your app, see Receipt Verification for IAP Apps. You can use RVS to get the promotion status for a customer's receipt. For details, see Promotional pricing in RVS.

Promotional pricing FAQs

Questions and answers to commonly asked questions about promotional pricing.

Q: Can an existing customer sign up for promotional pricing or see the promotional price offers?

A customer who hasn't enjoyed promotional pricing for a subscription product is eligible for the promotional pricing on that subscription. Additional conditions might apply based on your customer segment configuration.

Q: If an existing customer cancels their subscription and resubscribes later, will they be eligible for promotional pricing?

If the customer hasn't already enjoyed promotional pricing for a subscription product, they are eligible for the promotional pricing on that subscription. Additional conditions might apply based on your customer segment configuration.

Q: Can a customer who is currently enjoying promotional pricing, cancel the subscription and get promotional pricing again on resubscribe?
No, promotional pricing is once per subscription product.
Q: Can I use promotional pricing with other discount offers?
No, promotional pricing cannot be combined with any other price discount.
Q: What happens if the promotion dates are changed and published when the current promotion is already live?
The current dates are overwritten with the new configuration and the promotional price is granted to customers based on the new dates. For details, see Change promotional prices.

Last updated: Mar 13, 2023