Skip to main content
Samsung Developer Program

Test Your App Integration of Samsung IAP

How to test the Samsung IAP integration during app development and beta testing.

Samsung supports two types of testing before you submit your apps and in-app items to validation testing by Samsung in order to normally distribute them:

  • Development Testing - Permits in-house testing by developers without financial transactions.
  • Beta Testing - Permits full or partial testing by registered beta testers, either with or without financial transactions.
     

Note: In order to conduct development or beta testing, your app and in-app items do not need to be submitted for and pass Samsung validation testing.

To support both types of testing and normal distribution, Android apps can operate in one of three IAP operating modes:

  • Developer test modes
    • Developer test mode (success or failure)
      • For in-app item purchase IAP API calls:
        • These calls are not processed by Samsung IAP servers.
        • Only failure results are returned.
        • End-users are not billed.
           
      • For all other IAP API calls:
        • These call are processed as specified by Samsung IAP servers.
        • Success or failure results are returned.
           
    • Developer test mode (failure) 
      • All IAP API calls are not processed.
      • Only failure results are returned.
      • End-users are not billed for in-app item purchase IAP API calls.
         
  • Production mode 
    • All IAP API calls and transactions are processed as specified by Samsung IAP servers.
    • Success or failure results are returned.
    • Caution: 
      • For normally release apps, end-users are billed for app and in-app item purchases.
      • For beta release apps, beta testers are not billed for app purchases and may or may not be billed for in-app item purchases according to the beta test setup.
         

For more details, see IAP Operating Modes and Beta Testing.

 

Development Testing

Development testing enables you to test your Samsung IAP integration of in-app item functionality, except purchase functionality, before beta release and validation testing.

You must have a commercial Seller Office account and register your app, its binary files, and its in-app items in order for the Samsung ecosystem to support your app's offering and sale of the in-app items that are registered in Seller Office.

Getting a commercial Seller Office account takes some time. Therefore, Samsung provides you with a method to start integrating and testing Samsung IAP integration without having a commercial account. However, this method requires that you:

  • In your project file:
    • Use the package name: com.samsung.android.sdk.iap.sample5
    • Make IAP API calls that specify only the following in-app item IDs:
      ID Item Type
      consumable Consumable item
      non-consumable Non-consumable item
      ARS Automatically recurring subscription

 

To conduct development testing
without a commercial Seller Office account

  • In your project file:
    • Set the package name to com.samsung.android.sdk.iap.sample5.
    • Include processing for some or all of the in-app items with the IDs: consumable, non-consumable, and/or ARS.
    • Set the app operational mode to either:
      • Developer test mode (success or failure)
        mIapHelper.setOperationMode(OperationMode.OPERATION_MODE_TEST);
         
      • Developer test mode (failure)
        mIapHelper.setOperationMode(OperationMode.OPERATION_MODE_TEST_FAILURE);
        
        
         
  1. In Android Studio:
    1. Run your app.
    2. Conduct the development testing of the app and its in-app items.
      Test all integrated Samsung IAP API calls. 
      Test the purchase and processing of all integrated in-app items.

 

 

To conduct development testing
with a commercial Seller Office account

  • After you get your commercial account, we recommend that you test your app using this method.
  • In your project file:
    • Set the package name using your own criteria.
    • Include processing for some or all of the IDs for the in-app items that you plan to offer during beta or normal distribution.
    • Set the app operational mode to either:
      • Developer test mode
        mIapHelper.setOperationMode(OperationMode.OPERATION_MODE_TEST);
         
      • Developer test mode (failure)
        mIapHelper.setOperationMode(OperationMode.OPERATION_MODE_TEST_FAILURE);
        
        
         
    • Set other aspects (such as signing and filename).
      For details, see Application Binary Files.

 

  1. In Seller Office, register your Android app, a development version of its binary file, and its in-app items. For details, see How to Register Your Android App.
     
  2. Conduct the development testing of the app and its in-app items.
    Test all integrated Samsung IAP API calls. 
    Test the purchase and processing of all types of registered in-app items.

 

 

Beta Testing

Closed beta release enables beta testers to use a fully functional version of your app including the offering and purchase of in-app items from within the app. All beta testers download the app for free. You can set up the beta release so that beta testers either get in-app items for free or must pay for them, which tests item purchase functionality.

You must prepare, set up, and manage the beta testing before, during, and after the release of a beta app and its in-app items.

For more details, see Android and Galaxy Watch App Beta Testing Overview and IAP Operating Modes and Beta Testing.

 

To beta test your app and in-app items

  • Complete developer testing.
  • Set the package name using your own criteria.
  • Include processing for some or all of the IDs for the in-app items that you plan to offer during normal distribution.
  • Prepare for the beta release (such as selecting beta testers and setting up the beta release in Seller Office)
  • In your project file:
    • Set the app operational mode to production mode.
      mIapHelper.setOperationMode(OperationMode.OPERATION_MODE_PRODUCTION);

       
    • Set other aspects (such as signing and filename).
      For details, see Application Binary Files.
       
  1. In Seller Office:
    1. Register your Android app, a beta version of its binary file, and its in-app items.
      For details, see How to Register Your Android App.
       
    2. Set up the beta release (such as registering beta testers and select beta test options), and then beta release your app and in-app items by clicking Submit Beta Test.
      For details, see Android App Beta Testing.
       
  2. Manage the beta testing (such as communicating with beta testers, and enabling or disabling in-app item availability after the beta app distribution stops).
    For details, see Beta Test Your Apps and In-App Items.

 

 

  • Was this article helpful?