Skip to main content
Samsung Developer Program

Samsung In-App Item Types

Samsung IAP supports the Android app offering and sale of consumable items, non-consumable items, and subscription items that can have a free trial period and can be automatically renewed

You specify the type of each in-app item when you register items to your Android app in Samsung Seller Office. In-app items can be consumables (such as coins, energy, and lives for game apps), non-consumables (such as tools and weapons for game apps), and subscriptions (such as books and videos for service apps).  One in-app item can be one item or a collection of many items of the same type and subtype.

Note: Differences that depend on the version of Samsung IAP integrated by the Android app are stated.  If no differences are stated, then the statement applies to all versions of IAP.

 

Item Type
(IAP v5.x)

 

Item Subtype
(IAP v5.x)

Item Type
(Before IAP v5.x)

 

Item

 

Consumable

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:

  • For IAP v5.0 and later, the item can be initially purchased, but cannot be purchased again until the item has been reported as consumed. After that, it can be purchased again. 
  • Before IAP v5.0,  the item can be purchased one or more times without restrictions.
   

Non-consumable

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: Non-consumable 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. 
 

   

Non-renewable subcription

(Non-recurring subscription)

Before IAP v5.0 only.

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 Samsung IAP (such as email). While the subscription is active, new subscription components can be periodically issued. After the subscription expires, it is not automatically repurchased or renewed.

Note: Non-recurring subscription items can only be registered in bulk.

For all subscription items:

  • Subscription time period can be 1, 3, 6, or 12 months.
     
  • 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 Android app by methods that are independent of Samsung IAP (such as email).
    • The user can use the provided subscription components.
       
  • After the subscription expires, 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 2 hours, during which it cannot be repurchased.
  • After 2 hours, the subscription expires, is not automatically renewed, and can be purchased again.
     

In IAP production mode: 

  • A subscription remains active for one month, during which it cannot be repurchased.
  • After the subscription expires, it is not automatically repurchased and renewed, and the user can again purchase the subscription item.

Subscription

 

 

Auto-recurring subscription

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 Samsung 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, unless stopped by the user.

Starting with Samsung IAP v5.0, subscription items can offer a free trial period (7 to 999 days) before the first paid subscription time period.

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

For all subscription items:

  • Subscription time period can be:
    • For IAP v5.0 and later: 1 week, 1 month, 3 months, 6 months, or 1 year.
    • Before IAP v5.0: 1 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 Android app by methods that are independent of Samsung 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 the subscription, 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 2 hours, during which it cannot be repurchased.
  • After 2 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.

 

 

  • Was this article helpful?