en ko zh

Programming Guide

The Samsung In-App Purchase (IAP) programming guide explains how to integrate and configure IAP, defines the IAP SDK and IAP Server APIs, and briefly describes what to do before submitting your app to Galaxy Store.

By integrating IAP, your apps can sell two types of in-app products.

1. Item: Goods and services that charge users on a one-time basis.

   For consumable item purchases (for example, coins, special powers, gems), mark the item as consumed by calling the consumePurchasedItems() method so that the user can buy the item again after they have consumed it. Items can be repurchased only after the app reports them as consumed by calling consumePurchasedItems().

   For non-consumable item purchases (for example, e-books, game boards), acknowledge delivery of the item by calling the acknowledgePurchases() method. Make sure that the acknowledged items cannot be repurchased.

   NoteThe distinction between consumable and non-consumable types has been deprecated. Registering non-consumable items ended on January 14, 2026.
   
   To complete an Item purchase, if your app has a secure backend, we recommend verifying the purchase and calling the acknowledgment/consumption APIs from your server. If your app is client-only, call consumePurchasedItems() (repurchasable items) or acknowledgePurchases() (non-repurchasable items) from the IAP SDK in your app.

2. Subscription: A set of benefits that charges users on a recurring basis.

   App users can use subscription products as many times as they want during the free trial period or when a paid subscription is active.

   For subscription purchases (for example, magazines, e-zines, newspapers) acknowledge delivery of the subscription by calling the acknowledgePurchases() method.

   See the Subscription Guide for more information about subscriptions.

You can beta test your IAP integration before you submit your app for review and normal publication in Galaxy Store. See the Test Guide for more information.