Skip to main content
Samsung Developer Program

Design Tizen Wearable In-App Purchase Items

 

In-App Purchase (IAP) functionality enables you to sell in-app items directly from your watch face apps and watch apps. After your app user initiates the purchase of an in-app item, your app uses IAP API calls to cause IAP and supporting components to manage the back-end processing of purchase pricing, the purchase transaction, record-keeping, and financial reporting.  

Gear_InAppItem_Purchase_UI.png IAP_Purchase_Flow_2.png Gear_App_Uses_Purchased_Items.png

Your app presents IAP items to the user.

For a better UX, we recommend that your app:

  • Query in the background for available item info (including titles, descriptions, and prices)
  • Present IAP items in a clear and distinctive way

IAP displays current item and purchase information, and directs the user through the purchase transaction.

 

Your app responds to the purchase.

For a better UX, we recommend that your app deliver a clear message after completing purchases, whether successful or not.

In-App Item Types

Note: One in-app item can be one item or a group of many items of the same type.

 

Consumable

IAP_Items_Zynga.png

The in-app item (such as coins, lives, food, fuel and potions) remains available to the user until they use it one time, and then it cannot be used again. 

Note: Consumable items can be registered individually or in bulk.

For all IAP operating modes, the item can be purchased one or more times without restrictions.

 

Nonconsumable

 

The in-app item (such as a book, a premium upgrade of the user's account, progressively advanced race courses, removing advertising, or enabling a superpower for the user's game character) remains available for use indefinitely; the item does not become unusable.

Note: Nonconsumable items can be registered individually or in bulk.

In both IAP developer test modes, the item can be initially purchased, and then purchased again (to support testing) by re-initializing the IAP operating mode to a developer test mode at least 10 minutes after the last purchase.

In IAP production mode, the item can be initially purchased, but cannot be purchased again. 
 

 

Auto-recurring subscription

IAP_Items_workoutTrainer.png

The in-app item's subscription remains active for its specified time period, during which the user receives subscription components (such as newsletters, vouchers, books, or enhancements of the user's game character) through a method that is independent of IAP, such as email. While the subscription is active, new subscription components can be periodically issued. After the subscription expires, it is automatically repurchased and renewed. Subscription items can offer an initial free trial period (7 to 999 days).

Note: Auto-recurring subscription items can only be registered individually.

For all subscription items:

  • Subscription time period is one month.
  • While a subscription remains active:
    • Subscription components are provided to the user (for example, upon initial purchase, periodically while the subscription is active, and upon renewal) by you or your  app by methods that are independent of IAP, such as email.
    • The user can use the provided subscription components.
  • When a subscription expires, the user is automatically billed the item price and the subscription is renewed, unless stopped by the user.
  • After the user stops the subscription:
    • New subscription components are not provided.
    • All previously provided subscription components can be accessed and used indefinitely.
    • The user can again purchase the subscription item.

For subscription items without a free trial period:

  • When the user initially purchases the subscription item:
    • The purchase and payment transaction:
      • Bills the user for the item's price.
      • Commits the user to automatic renewal (including item price billing) after the subscription expires.
    • The subscription time period begins after a successful purchase transaction.

For subscription items with a free trial period:

  • When the user initially 'purchases' the subscription item:
    • The purchase and payment transaction:
      • Does not bill the user for the item's price.
      • Commits the user to automatic renewal (including item price billing) after the free trial period expires.
    • The free trial period begins after a successful 'purchase' transaction.
       
  • During the free trial period, the subscription is active and subscription components can be provided and used.
     
  • After the free trial period: 
    • The user is billed the item price and the subscription time period starts.
    • The subscription remains active for its specified time period
    • After each subscription expires, the user is automatically billed the item price and the subscription is renewed, unless stopped by the user. 
       
  • After stopping subscription renewal, the user:
    • Can continue to use all subscription components they previously received.
    • Does not receive new subscription components.
    • Can again purchase the subscription item.

In both IAP developer test modes: 

  • A subscription remains active for two hours, during which it cannot be repurchased.
  • After two hours, the subscription expires, is not automatically renewed, and can be purchased again.

In IAP production mode: 

  • A subscription remains active for its specified time period, during which it cannot be repurchased.
  • After the subscription expires, it is automatically repurchased and renewed, unless stopped by the user. 
  • After renewal is stopped, the user can again purchase the subscription item.