Skip to main content
Samsung Developer Program

Develop In-App Purchase Items

 

Your Android apps can sell in-app items after you integrate Samsung In-App Purchase (IAP) functionality via one of the following methods:

Samsung In-App Purchase SDK

Android SDK containing an AIDL library and a helper class

  • For integration into native Android apps.
  • Apps and their items can only be marketed via the Galaxy Apps store.

Samsung OpenIAB Unity Plugin

Plugin for Unity applications

  • The open source OpenIAB library is an easy way to develop apps so that one APK can be marketed in all OpenIAB-compliant app stores, ensuring that the proper IAP API set is used for each app store.
  • The Samsung OpenIAB Unity plugin and library extend OpenIAB purchasing and billing transaction management by relying on Samsung IAP 4.0.1, including its latest features.

Unity IAP Services

Implements Samsung IAP functionality via the Unity IAP API.

  • You can distribute your apps and their items in many supported app stores (such as Samsung Galaxy Apps, Google Play™, iOS App Store, Mac App Store, and Amazon Appstore).
  • For Unity game developers, this simplifies the in-app purchase setup across multiple platforms.

 

There are many ways you can design and develop your app to support the sale of in-app items. The following is a straightforward method that relies on direct integration of Samsung IAP and the Android SDK, in order to demonstrate the key steps and Samsung IAP API calls.

  1. Get a commercial Seller Office account.
  2. Register your app and its in-app items with Samsung Seller Office and get them certified.
    Note: To test in-app item purchases, your app and items only need to be registered. They do not need to be certified.
  3. Support and process in-app item purchase transactions: 

    IAP_Purchase_Flow_1.png

    In your app:

    a.  Initialize IAP in the appropriate operating mode (Test or Commercial) by making a getInstanceclient API call.

    b.  Present in-app items to your users:
    • Retrieve all items currently available for purchase, including current local prices, by making agetItemListclient API call.
    • Retrieve the items the user has already purchased, by making agetInboxListclient API call. 
    • Enable users to select and initiate a purchase.

    c.  After the user initiates the purchase of an in-app item, start purchase processing by making astartPaymentclient API call.

    IAP_Purchase_Flow_2.png

    Samsung IAP manages the item purchase:

    a.  Gets current item information (such as pricing).

    b. Presents purchase information and options to the user.

    c. Gets purchase authorization and payment from the user.

    d.  Notifies your app of the results of the purchase transaction.

    IAP_Purchases_Flow_3.png

    In your app:

    a.  Verify the purchase by making anappsItemVerifyIAPReceiptserver API call.

    b.  For auto-recurring items, get detailed information by making a checkARSStatusserver API call.  To call checkARSStatus requests, you need to get token information by making a createServiceToken server API call.

    c.  Manage the results of the purchase (for example, by providing user feedback and making the item available to the user).

 

  • Was this article helpful?