Test Guide
test guide 1 overview 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 2 iap test environment 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 test transactions iap operating mode app status always successful side load no charge operation_mode_test registering always fail side load no charge operation_mode_test_failure registering production closed beta no charge or charge depends on type of tester operation_mode_production beta deployed cautiondo not test when the iap operating mode is ‘operation_mode_production’ and the app status is ‘registering’ iap functionality is not supported under these conditions iap test transaction types iap testing supports ‘no charge’ and ‘charge’ transactions for item purchases 1 no charge transactions item payments are not reported to the payment gateway pg card company or payment agency for successful transactions, purchase emails, with amounts, are sent to testers in the item purchase ui popup, the ‘sandbox’ icon is displayed details depend on the iap test environment and type of tester iap operating mode tester type details operation_mode_test licensed testers testers always get purchased items - iap always reports successful purchases for non-consumable items, the purchase record is initialized every 10 minutes to allow repurchase for subscription items, the subscription cycle is automatically renewed every 10 minutes and the subscription is automatically canceled after 12 renewals operation_mode_test_failure all types testers never get purchased items - iap always reports failed purchases operation_mode_production all types for successful purchases, testers get items - iap reports success 2 charge transactions for successful transactions, item payments are reported to and authorized by the payment gateway pg card company or payment agency , and iap reports purchase amounts in the item purchase ui popup, the ‘sandbox’ icon is not displayed only occur for operation_mode_production beta tests and non-licensed testers for successful purchases, testers get items and are charged, and iap reports successful purchases 3 iap testing 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 3 1 preparation 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 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 3 2 test type 1 always successful side load test purpose and use test offerings, purchases, and payments of all items test subscription items at iap test periods commonly used during app, in-app item, and iap integration development prepare the app and in-app items for testing iap operating mode is set to operation_mode_test 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 2 always fail side load test purpose and use test offerings and failed purchases and payments of all items commonly used during app, in-app item, and iap integration development prepare the app and in-app items for testing iap operating mode is set to operation_mode_test_failure install the app on a test device by an independent method such as side loading test item offering and purchase a testers always do not get items and are not charged b iap reports all item purchases and payments as failed 3 production closed beta test caution apps deployed for beta testing must only be installed using the beta testing url if sideloaded, item information is not accessible if the beta test app is updated and a newer version is deployed, testers must delete the earlier beta test app from their device and re-install the app purpose and use all beta testers can test offerings, and successful and failed purchases and payments of all items consumable, nonconsumable, and subscription non-licensed testers test subscription items at registered item periods licensed testers test subscription items at iap test periods commonly used to test initial versions and update versions of apps and their items as a last development phase before normal publication notethe following steps are used for beta test setup and testing to be performed by the same person typically, a beta test conductor sets up a beta test to be run by many beta testers 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 non-licensed testers can get purchased items and are charged registered item periods apply to subscription items licensed testers can get purchased items and are not charged iap test periods apply to subscription items iap reports successful and failed transactions, and actual item purchase amounts for successful transactions 6 test purchased subscription items 3 3 testing item offering and purchase 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 noteitem coupons, free trial periods, lower-tier prices, and auto payment due dates are displayed but do not apply during iap testing 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 noteiap test preparation sets whether or not payment-complete or payment-failed messages are displayed test descriptions always success side load testing a payment-complete message is displayed when configured - the purchase item is added to your account - an item purchased email is sent to you always fail side load testing a payment-failed message is displayed when configured - the purchase item is not added to your account production closed beta testing for successful purchases - a payment-complete message is displayed when configured - the purchase item is added to your account - an item purchased email is sent to you - if you are a non-licensed tester, you are charged - if you are a licensed tester, you are not charged for failed purchased - a payment-failed message is displayed when configured - the purchase item is not added to your account - you are not charged 3 4 testing subscription items 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 noteeach subscription in-app item can have 1 free trial period optional , 1 to 100 lower-tier price periods optional , and regular-tier price periods required, but they can be canceled at any time by testers, or are automatically canceled after 12 periods when iap test periods apply depending on the iap test environment, free trial and subscription periods end after either registered item periods free trial and subscription periods end as specified in the subscription item’s seller portal registration, which can be weeks, months, or years apply during production closed beta tests for non-licensed testers iap test periods free trial and subscription periods end every 10 minutes on the hour at hh 10, hh 20, hh 30, … the first period after purchase or repurchase ends at the next 10-minute time for example, if an item with a free trial is first purchased at 11 08, free trial ends at 11 10 apply during always successful side-load tests for all testers, and production closed beta tests for licensed testers notewhen testing in india, the user's extension status is checked every 10 minutes to test subscription items set up the test environment always successful side-load test or production closed beta test and non-licensed testers and/or licensed testers notethe following steps are for side-load testers and licensed testers who are not charged for purchases, and free trials and subscriptions end at iap test periods non-licensed testers are charged for purchases, and periods end as registered purchase a subscription item noteif an item with a free trial and/or lower-tier pricing is purchased in an iap test, and the same tester purchases the same item in another iap test, the free trial and lower-tier pricing will not be in effect to test a free trial or lower-tier pricing again, either re-register a new item for example, with a different name , and have the same tester purchase the item have another tester purchase the item test item after initial purchase verify the following occur according to the diagrams below for the applicable scenario free or registered purchase price, and other purchase details, in the purchase email sent to you first auto-payment email is sent at the next 10 minutes on the hour and the first auto-payment price registered lower-tier or regular-tier additional auto-payment emails are sent every 10 minutes on the hour and the auto-payment price registered lower-tier or regular-tier test item auto-payment a auto-payments are made 12 times every 10 minutes b verify the following occur according to the diagram below for all item types • regular-tier price in the purchase email sent to you soon after purchase • first auto-payment email is sent 10 minutes on the hour after purchase • regular-tier price in all auto-payment emails sent every 10 minutes on the hour test manual subscription cancellation a in galaxy store at any time before auto-cancellation, click menu > subscription > [select a subscription] > unsubscribe b verify a cancellation email is sent to you test item re-subscription a cancelled subscription expires at the end of the current test cycle which is the next 10 minute mark of the hour for example, hh 00, hh 10, hh 20, hh 30, hh 40, hh 50 before expiring, you can re-subscribe to the cancelled subscription a to re-subscribe, in galaxy store, click menu > subscription > [select a canceled subscription] > resubscribe example subscription item testing non-introductory subscription item with purchase, free trial and automatic cancellation after 12th auto-payment the test subscription in-app item has a 7-day free trial period and a regular $4 99 monthly subscription price times hh mm local time are for listed events * after 12 automatic payments, the expiration date changes to the current date and time, allowing new purchases introductory subscription with purchase, free trial and automatic cancellation after 12th auto-payment the test subscription in-app item has a 7-day free trial period, a $2 99 introductory monthly subscription price for 3 months, and a $4 99 regular-tier monthly subscription price times hh mm local time are for the listed actions and events * after 12 automatic payments, the expiration date changes to the current date and time, allowing new purchases non-introductory subscription with purchase, free trial, manual cancellation the test subscription in-app item has a 7-day free trial period and a $4 99 regular-tier monthly subscription price times hh mm local time are for listed events * when a subscription is cancelled in test mode, the subscription expires at the end of the current test cycle which is the next 10 minute mark of the hour for example, hh 00, hh 10, hh 20, hh 30, hh 40, hh 50 non-introductory subscription with purchase, free trial, manual cancellation, and re-subscribe from galaxy store the test subscription in-app item has a 7-day free trial period and a $4 99 regular-tier monthly subscription price times hh mm local time are for listed events * when a subscription is cancelled in test mode, the subscription expires at the end of the current test cycle which is the next 10 minute mark of the hour for example, hh 00, hh 10, hh 20, hh 30, hh 40, hh 50 ** re-subscription is only possible before the end of the current test cycle after cancellation *** after 12 automatic payments, the expiration date changes to the current date and time, allowing new purchases 4 after iap testing 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 noteyou can only track the purchase history of a beta test app during beta testing when the app is updated to a regular non-beta installation, the beta test purchase history is no longer available to prepare 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 cautionif an app with the iap operating mode set to operation_mode_test is normally published, licensed testers are not charged for in-app item purchases all other users receive an error message 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