Setting Up In-App Purchases
To offer items for in-app purchase (IAP) through ONE store, integrate your app with the ONE store IAP SDK and register each IAP item in the ONE store Developer Center. For more information, see Registering IAP Items.
Once integration and item registration are complete, perform test purchases of each IAP item prior to submitting your app for review. For more information, see Testing IAP Items.
Offering IAP items in the US region requires ONE store IAP SDK version 21.02.00 or later. For more information, see Integrating the ONE store IAP SDK.
Registering IAP Items
You can register the following types of IAP items:
Managed Products: One-time purchases that permanently unlock app features for the user. For more information, see Registering Managed Products.
Subscriptions: Recurring purchases that grant access to features for a set billing period. Access is revoked if the user cancels or automatic billing fails. For more information, see Registering Subscriptions.
Registering Managed Products
Managed Products are premium features or content you want to offer to your users for purchase. Once purchased, these features are permanently unlocked for the user.
To register a Managed Product for IAP:
In the ONE store Developer Center, go to APPS→Applications.
Select your app and go to In‑App→Managed product. A listing of your registered IAP items appears.
Click + Register product. The In‑App Product Information page appears.
For the ID section, enter a unique identifier for your IAP item and click Check duplication to verify that the ID you entered is unique.
Once you save this item, you cannot modify the ID for this IAP item or reuse the ID for another IAP item.
For the Title section, enter the name of your IAP item in the default language of your app. For the US region, providing titles in English and Spanish is recommended.
To add a title in an additional language, click + Add a language, select the language you want to add, and enter the item title in the selected language.
For the Basic Price section, enter the price of the IAP item and click Exchange rate update. Prices in the Local prices section are calculated based on the current exchange rate and displayed. For more information, see the ONE store FAQ about local pricing.
To specify a different base currency, go to Apps→Settings→Default Price Currency Settings, select the desired base currency, and click Save.
Modify the calculated local prices as needed.
Click Save. The item you entered now appears in Draft status in the list of registered IAP-managed products for your app.
Registering Subscriptions
Subscriptions enable you to charge users for the app or service for a defined period, with payments automatically billed at a set frequency. Register each subscription option as an individual IAP item. For more information about each subscription setting, see Registering Subscription Products in the ONE store Developer Center documentation.
To register a subscription for IAP:
In the ONE store Developer Center, go to APPS→Applications.
Select your app and go to In‑App products→Subscription.
Click + Register Product. The In‑App Product Information page appears.
For the ID section, enter a unique identifier for your subscription item and click Check duplication to verify that the ID you entered is unique.
Once you save this item, you cannot modify the ID for this IAP item or reuse the ID for another IAP item.
For the Title section, enter the name of your subscription item.
For the In-App Price information section, enter the Basic Price in KRW.
For the Billing Period drop-down list, select a billing frequency.
If you want to allow users to try your app for free before billing them, select On in the Free Trial section and enter the number of Days you wish to offer the app for free.
If you want to offer a lower price for first-time subscribers, select On in the Introductory period section and enter the number of Billing Period days for the promotion duration.
If a Free Trial period is also set, the Introductory price is applied after the Free Trial period ends. After the Introductory price billing period ends, billing at the Basic Price begins.
If you want to allow users a grace period for failed payment, select the number of days in the Grace period section.
Click Save.
The item you entered now appears as Draft status in the list of registered IAP subscriptions for your app.
Managing Subscription Settings
Subscription settings allow you to define global options for all subscription types within your app. You can control whether users can pause their subscriptions and how free trials are granted. These settings apply to all subscription products for your app but do not affect individual pricing or trial durations, which you configure separately for each subscription.
To manage subscription settings:
In the ONE store Developer Center, go to APPS→Applications.
Select your app and go to In‑App products→Subscription. A list of your registered subscription items appears.
Click Manage Subscription Settings. The Manage Subscription Settings window appears.
To allow users to pause a subscription, select Pause. Allowing subscription pauses offers an alternative to canceling, and users can resume the subscription at a later time.
To allow free trials for each subscription type, select Allow Free trial by subscription. Otherwise, to limit users to only one free trial across all subscription types for the app, uncheck Allow Free trial by subscription.
Click Confirm. The updated global subscription settings appear in the Subscription page.
Testing IAP Items
The ONE store app approval process requires that you perform a virtual purchase of each IAP item in the Sandbox environment. Before performing test purchases of IAP items, complete the following tasks:
If you have not already done so, upload the binary file for your app integrated with the IAP SDK version 21. For more information, see Uploading a Binary File.
On an Android test device or emulator, install the following apps:
ONE store version 4.0.0 for the US region.
Your app that uses the same signing key as the registered binary file.
To test IAP items:
Step 1: Register a ONE store Test Account
To perform test transactions, set up a ONE store account specifically for testing purposes.
To set up a test account:
On the test device or emulator, open ONE store and create a user account.
In the ONE store Developer Center, go to APPS→Applications.
Select your app and go to In‑App→Billing Test. The Test ID mgmt. tab appears.
In the TEST ID Search field, enter the user account and click Search. The user account for testing appears in the Results section.
For Test environment, select Sandbox.
Click Register. The ONE store user account is now a registered test account for the Sandbox environment and appears in the list of Test IDs.
Step 2: Purchase IAP Items in the Sandbox
Once you have set up a test account for the Sandbox environment, purchase each IAP item using the registered ONE store test account from Step 1.
To purchase an IAP item in the Sandbox:
On your test device or emulator, launch your app and navigate to the IAP item purchase page.
Tap to purchase the item. The ONE store app opens to complete the purchase using the registered Sandbox testing account.
Run the transaction type you want to test. To simulate a successful payment, tap Success. To simulate a failed payment, tap Fail. ONE store assigns each Sandbox purchase with a Purchase ID.
Track the Purchase IDs so that you can verify the purchase in the ONE store Developer Center.
Repeat Steps 1‑4 for each IAP item you want to test.
Step 3: Verify Sandbox Purchases
Once you have completed the test purchases in the Sandbox, verify that the IAP items were successfully purchased and now show as tested items.
To verify Sandbox purchases:
In the ONE store Developer Center, go to APPS→Applications.
Select your app, go to In‑App→Billing Test, and select the Sandbox tab. The Sandbox tab appears with a list of completed test transactions.
Verify the test purchases using the Purchase ID.
Go to In‑App→Managed product.
Verify that the IAP items you tested are marked Y in the Tested column.
Tested items remain in Draft status until your app passes the publication review process
Last updated