EN CN
Samsung In-App Purchase (IAP) supports your app IAP-integration and in-app item development testing of in-app item offering, purchase, and payment functionality before you submit your apps and in-app items (consumable, nonconsumable, and subscription) to validation testing and normal publication in Galaxy Store.
IAP testing of in-app item offerings (when your app gets and presents current item prices and details to app users) is the same as for normal publication. IAP testing of in-app item purchase and payment is the same as for normal publication except for subscription item testing changes, and some testers get items for free.
Determine the IAP tests and type of purchase and payment transactions to test items with.
In your app code, set the IAP operating mode indicated below. In the Seller Portal: register your app and in-app items, set up closed beta testing (if used), and set the app status indicated below.
IAP testing supports ‘no charge’ and ‘charge’ transactions for item purchases.
When creating tests of your app, in-app items, and Samsung IAP, the IAP tests are guidelines for test setup and initiating and verifying IAP functionality. You can test your app and in-app items with one or more IAP tests.
For all IAP tests, prepare your testers, app, and in-app items:
Ensure each tester has a valid credit card for payment. Side load tester and licensed tester credit cards are not billed for any item purchases. Non-licensed tester credit cards are billed for all item purchases.
In your app code: a. Set the IAP operating mode for the selected IAP test. mIapHelper.setOperationMode(HelperDefine.OperationMode.[IAP operating mode for the selected test]) b. Set whether or not payment-complete or -failed messages are to be displayed during item purchasing IapHelper.startPayment class parameter _showSuccessDialog is true or false
mIapHelper.setOperationMode(HelperDefine.OperationMode.[IAP operating mode for the selected test])
IapHelper.startPayment class parameter _showSuccessDialog is true or false
Build the app APK. For details, see the ProgrammingGuide.
In the Samsung Galaxy Store Seller Portal: a. Register the app and in-app items. b. Set the app status for the selected IAP test.
Prepare the app and in-app items for testing.
Install the app on a test device by an independent method (such as side loading).
Test item offering and purchase: a. Testers always get purchased items and are not charged. b. IAP reports all purchases as successful and the purchase amounts.
Test subscription items.
If the app was previously side loaded onto the test device, uninstall the app.
Prepare the app and in-app items for testing. IAP operating mode is set to OPERATION_MODE_PRODUCTION.
In Seller Portal: a. Register the app and its items. For details, see the App Registration Guide and In-App Purchase Guide.
b. Set up the closed beta test: In the Binary tab of the Seller Portal app registration, register all testers (non-licensed and licensed) and the feedback channel for the closed beta test.
In your Seller Portal profile, register the licensed testers.
c. Submit the app and its items for beta release by clicking Submit Beta Test. For more details, see the App Registration Guide. 4. On each beta tester’s device, download the beta app from a beta test URL. 5. Test item offering and purchase: Typically, some testers are non-licensed and some are licensed.
6.Test purchased subscription items.
The following steps can be run for each tested in-app item:
Test in-app item offering: a. In the app, initiate the display of the current price and details for each item. b. Verify that item information matches the price and details registered in Seller Portal.
Test in-app item purchase: a. In the app, initiate the purchase of an in item. b. For licensed testers, click OK.
c. For Always Successful Side Load and Always Fail Side Load testers, click CONTINUE.
d. In the purchase popup: No Charge transactions Charge transactions
(1) Verify the item details match those registered in Seller Portal.
(2) Select payment method and verify payment information is correct. (3) Select ‘Point and coupons’ and verify displayed information is correct. (4) Click the [item purchase button].
e. Verify the following:
For Auto-Recurring Subscription (ARS) items, you can test their offering, purchase, free trials, lower and regular tier pricing, automatic payments, manual subscription cancellation, and repurchase.
Registered item periods
IAP test periods
To test a free trial or lower-tier pricing again, either:
In both examples, either a side-load test was set up with a tester, or a production closed beta test was set up with a registered licensed tester. Free trial and subscription periods were at IAP test periods, and free trial and lower pricing are not in effect after item repurchase.
Times (hh:mm local time) are for listed events.
After you complete all IAP testing and before you submit your app and its in-app items for validation testing, you must prepare them for normal publication.
For subscription items purchased during IAP testing, ensure their subscriptions are canceled.
Delete the tested app from the tester mobile device(s).
In the app code to be submitted for validation testing, ensure that the IAP operating mode is OPERATION_MODE_PRODUCTION.
In Seller Portal: a. Delete all licensed testers that are registered in your profile. b. If the app was changed after IAP testing, update the app registration with the production version of the app and change the registration information as necessary. c. Submit the app for validation testing by Samsung and normal publication in the Galaxy Store. For details, see the Application Registration Guide.