Skip to main content
Samsung Developer Program

IAP Operating Modes and Beta Testing

Samsung In-App Purchase (IAP) can operate in three modes: two modes to support Android app development testing that do not result in actual financial transactions, and a release production mode that does result in actual financial transactions.

 

Samsung IAP supports Android app integration testing during development, and supports normal operations, including beta testing, after app development.

IAP Operating Modes

IAP operating modes fundamentally control in-app item functions:

  • During Android app development and testing:
    • You must ensure actual financial transactions do not occur by setting either of two developer test modes.
    • We recommend you test your Android app under various conditions in both test modes.
  • Before validation submission, you must ensure actual financial transactions do occur by setting the production mode.
     

Production Mode

Normal operating mode

  • In-app items can be retrieved, purchased, and consumed.
  • IAP Helper purchase requests:
    • Are processed as specified and may succeed or fail.
    • Successful in-app item purchases result in actual financial transactions (such as billing end-user credit cards) when:
      • The Android app is registered, validated, and being distributed in Galaxy Apps.
      • In-app items are registered and validated.
  • All other IAP Helper requests are processed as specified and may succeed or fail.
  • Production mode must be set after development and testing has been completed and before submitting your Android app and its in-app items for validation.

 

Caution:  If an Android app is distributed in production mode:

  • IAP Helper purchase requests:
    • Will not result in actual financial transactions. 
    • Result in displaying an Unknown Error popup.
      SamsungIAP_Overview_UnknownErrorPopup_Screenshot.png

Developer Test Mode (Success)

 

Testing mode that always reports successful results

  • In-app items can be retrieved, purchased, and consumed.
  • IAP Helper purchase requests:
    • Are processed as specified and always report successful results.
    • Do not result in actual financial transactions.
  • All other IAP Helper requests are processed as specified and always report successful results.
  • This testing mode is to be set only during development and testing.

Developer Test Mode (Failure)

Testing mode that always reports failed results

  • In-app items cannot be retrieved, purchased, or consumed.
  • All IAP Helper requests are not processed and are reported as having failed.
    Note: In-app item purchase requests do not result in actual financial transactions.
  • This testing mode is to be set only during development and testing.

Beta Testing

The Samsung ecosystem supports distribution of your beta release Android app and its in-app items under closed beta testing conditions, which limits app download and in-app item purchase to registered beta testers, and controls the payment of fees. 


In closed beta testing:

  • You:
    • Register your free or paid Android app and its in-app items.
    • Register beta test information:
      • The Samsung Account name of up to 1000 beta testers.
      • The URL where testers can send you feedback
      • When beta testing starts and ends.
         
    • Submit your app for beta test release.
    • Send your beta testers the URL where they can download your app.
    • Respond to beta tester feedback that they provide in beta app product detail page in the Samsung app store, or to your beta testing feedback channel address
    • Can stop beta testing before it is scheduled to end by suspending the distribution of your app.
       
  • Galaxy Apps
    • Distributes your app under beta release conditions.
    • Only enables app download and in-app item support for registered beta testers between beta test start and stop dates or before you suspend it.
    • After beta testing, disables app download and in-app item support.
       
  • Beta testers:
    • Must have Samsung Galaxy phone devices with the proper Galaxy Apps versions.
      • Galaxy phones must have installed Galaxy Apps version 4.1.03-1 or higher.
      • Android phones must have installed Galaxy Apps version 4.2.04 or higher.
         
    • During beta testing:
      • Must follow the beta-test URL and use their registered Samsung Account name to download the app.
      • Paid apps are downloaded for free.
      • Must use their registered Samsung Account name to get in-app items.
         
    • After suspension of beta testing:
      • Cannot download the app or get in-app items.
      • Can continue to use a previously downloaded app and purchased in-app items.
         

For more details about open and closed beta testing, see Beta Testing.

  • Was this article helpful?