Registering and Testing IAP Items

For in-app purchase (IAP) items to be available through ONE store, integrate your app with the ONE store IAP SDK. Additionally, register each IAP item in the ONE store Developer Center.

Important

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

Register each IAP Managed Product you want to sell in the US.

To register an IAP item:

  1. In the ONE store Developer Center, go to APPS→Applications.
  2. Select your app and go to In‑App→Managed product.
    A listing of your registered IAP items appear.

Note

In the US region, only in-app purchase of items (ONE store Managed Products) is supported, while in-app purchase for subscriptions is not.

  1. Click + Register product.
    The In‑App Product Information page appears.

ONE_Register-IAP_2025-05-22_12-26-50.png

  1. 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.

Important

Once you save this item, you cannot modify the ID for this IAP item or reuse the ID for another IAP item.

  1. 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.
  2. 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.
  3. 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.

Note

To specify a different base currency, go to Apps→Settings→Default Price Currency Settings, select the desired base currency, and click Save.

  1. Modify the calculated local prices as needed.
  2. Click Save.
    The item you entered now appears as Draft status in the list of registered IAP items for your app.

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 IAP SDK version 21. For more information, see Upload 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:

  1. On the test device or emulator, open ONE store and create a user account.
  2. In the ONE store Developer Center, go to APPS→Applications.
  3. Select your app and go to In‑App→Billing Test.
    The Test ID mgmt. tab appears.

ONE_TestIDMgmt_2025-05-22_16-44-18.png

  1. In the TEST ID Search field, enter the user account you created in Step 1 and click Search.
    The user account for testing appears in the Results section.

ONE_TestID_2025-05-22_16-42-05.png

  1. For Test environment, select Sandbox.
  2. 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.

ONE_TestIDManage_2025-05-22_17-17-53.png

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:

  1. On your test device or emulator, launch your app and navigate to the IAP item purchase page.
  2. Tap to purchase the item.
    The ONE store app opens to complete the purchase using the registered Sandbox testing account.
  3. 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.
  4. Track the Purchase IDs so that you can verify the purchase in the ONE store Developer Center.
  5. 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:

  1. In the ONE store Developer Center, go to APPS→Applications.
  2. 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.

ONE_Sandbox_2025-05-22_17-38-28.png

  1. Verify the test purchases using the Purchase ID.
  2. Go to In‑App→Managed product.
  3. Verify that the IAP items you tested are marked Y in the Tested column.

ONE_IAP-Verify_2025-05-22_17-55-51.png

Note

Tested items are set to Draft status until your app passes the publication review process.

Back to Top ⇧