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 Android app and its in-app items.
    • Register the Samsung Account name of each beta tester.
    • Specify when beta testing starts.
    • Click 'Submit Beta Test'.
    • Send your beta testers the URL where they can download your Android app.
    • End beta testing by suspending the distribution of your Android app.
       
  • Galaxy Apps
    • Distributes the Android app under beta release conditions.
    • Only enables app download and in-app item support for registered beta testers.
    • After suspension, disables app download and in-app item support.
       
  • Beta testers:
    • During beta testing:
      • Must follow the beta-test URL and use their registered Samsung Account name to download the app.
        Note: Beta testers download paid apps for free.
      • Must use their registered Samsung Account name to get the app's in-app items.
         
    • After suspension of beta testing:
      • Cannot download the app.
      • Can continue to use a previously downloaded app.
      • Cannot use the app's in-app items.

 

  • Was this article helpful?