Pre-Preparations for ONE store IAP

Register App

Go to the ONE store Developer Center > APPS and click on the 'Register App' button to register the app. Once the app is registered, an application identifier (AID) will be issued.

Register Payment Information

First, you must register your payment information to register and sell paid products (in-apps). The information to be entered and the documents to be submitted may vary depending on your membership type. For details related to the developer member, refer to the Member's Page in the Developer Guide.

• Payment information: click on 'Developer Center > Manage Your Information > Information for Payment' tab

• The business member must get approval from the operator after registering his/her settlement information.

Register In-App

You can register the In-App product at the 'Developer Center > APPS > In-App Information' page. In-App products are divided into management-type products and subscription products.

Register Management Products Individually

• Register the in-app by clicking on the Register In-App button from the Manage Products menu on the In-App Information screen.

• In-App ID: Enter the in-app ID of the in-app and check if there is any duplicate ID. The in-app ID must be a unique value within the app.

• In-App Title: Enter the title of the in-app. The title will be exposed in the billing screen and purchase history.

• In-App Path: This is a path to check the in-app product within the app and is not a required value. This information will be reviewed by the ONE store review team.

• In-App Price: Input the selling price of the in-app. Enter the price including value added tax (VAT).

• After filling in the required fields, click on the Save button at the bottom.

  

Batch Registration of Management Products

• Step 1. Click on 'Download batch registration form' to download the form.

• Step 2. Complete in the downloaded form.

• Step 3. Click on 'Batch registration of In-App products' to upload the form.

• Step 4. Check if all the in-app products have been normally registered.

  Up to 500 in-app products can be registered in the batch registration form.

  If you need to register more than 500 in-apps, please upload multiple batch registration forms.

Register Subscription Products

• Register the subscription product by clicking on the Register In-App button from the Manage Subscription Products menu on the In-App Information screen.

• In-App ID: Enter the in-app ID of the in-app and check if there is any duplicate ID. The in-app ID must be a unique value within the app.

• Subscription Product Title: Enter the title of the in-app. The title will be exposed in the billing screen and purchase history.

• Subscription Product Path: This is a path to check the in-app product within the app and is not a required value. This information will be reviewed by the ONE store review team.

• Subscription Product Price: Input the base selling price of the subscription product. Enter the price including value added tax (VAT).

• Subscription Product Payment Period: Select the period during which the subscription product can be used. Your payment will be renewed accordingly.

  • Weekly / Monthly / 3-months / 6-months / Annually

    For monthly products, 3-month products, and 6-month products, payment will be made on the same day of the following month. For example, if a subscription started on January 15th, the next payment will be made on February 15th. However, if there is no same date, the last day of the month will be the payment renewal date. For example, if a subscription started on January 31st, the next payment will be made on February 28th (or 29th), and the next payment will be made on March 28th (or 29th).

• Free Subscription Period: By offering a free subscription period, users can try the product before deciding whether to subscribe to it or not. Free subscriptions are not provided to the same user more than once for each subscription product.

• New Discount Promotion Price: Select the new discount promotion price and duration. The discount promotion price cannot be higher than the base price of the subscription product.

  The payment period of the new discount promotion follows the payment period of the subscription product. For example, in the case of a subscription product with a monthly payment period, if you set the promotion for 3 payment periods, the user will receive a discounted price for 3 payments (3 months).

• Payment Grace Period: In case of a problem with the payment method, you can decide whether to provide a grace period to the user. If a grace period is provided, the user can use the content normally during the grace period.

  If there is a problem with the payment method, your subscription will not be immediately canceled, even if you do not set a payment grace period. The user's account is placed on hold, and recurring payments are made when the payment issue is resolved.

• After filling in the required fields, click on the Save button at the bottom.

  

Manage Subscription Products

• In the Subscription Products menu, click the Manage Subscription Products Settings button.

• From that menu, you can set whether to pause the subscription or set it as free to use.

• Please note that pausing or setting as free to use applies to all subscription products.

  

Check License Key (public key) and OAuth Credential

You can check OAuth credentials for the license key (public key) and server API by clicking on the ONE store Developer Center > Apps > In-App Information > Manage In-App API button.

• License key: Used for confirming whether the IAP history sent by ONE store is forged or falsified.

• OAuth credential: Used to authenticate and use the ONE store server API.

  

Download Sample App

You can download the IAP sample app from Github.

• Download ONE store IAP API V7 (SDK V21) Sample App

Add IAP Library

Register the ONE store maven address in the project top-level build.gradle file.

hljs.highlightAll();

repositories {
    ...
    maven { url 'https://repo.onestore.co.kr/repository/onestore-sdk-public' }
}

Add ONE store payment library dependencies to the app's build.gradle file.

hljs.highlightAll();

dependencies {
    implementation "com.onestorecorp.sdk:sdk-iap:21.0.0"
    implementation "com.onestorecorp.sdk:sdk-configuration-kr:1.0.0"
}

Install the ONE store app

The ONE store Service (OSS) app is necessary for developers and users to use ONE store IAP. OSS has been installed by default on Android smartphones released by local mobile carriers (SKT, KT, U+), but it has not been installed by default on terminals (Pixel, etc.) or tablets released overseas. Depending on the conditions of the terminals developing ONE store IAP modules, you will need to download OSS and keep it up to date by using the guides below.

• Smartphones released by local mobile carriersONE store apps have been installed by default on Android smartphones launched by mobile carriers.The developer can update ONE store apps to the latest version by using ONE store client (OSC) app, a built-in app.Execute ONE store (or T Store or Olleh Market or U+Store) installed on the smartphone to update OSC and OSS (older devices may not be supported with automatic updates).

• Smartphones/tablets released overseas & terminals distributed by manufacturers Since ONE store apps are not installed by default on the smartphones or tablets released overseas and on the terminals distributed by manufacturers, you must download and install OSC and OSS.Click on the link below and install the ONE store apps necessary for IAP development (only available on mobile) Go to download OSC & OSS

  ONE store IAP works on Android devices with Android OS 4.1 and above. Check the OS version of the terminals prior to interworking with the IAP module.

• Register App

• Register Payment Information

• Register In-App

  • Register Management Products Individually

  • Batch Registration of Management Products

  • Register Subscription Products

  • Manage Subscription Products

• Check License Key (public key) and OAuth Credential

• Download Sample App

• Add IAP Library

• Install the ONE store app