ONE Store

Classic/VPC環境で利用できます。

ONE Storeビルドのためのコンソールご利用ガイドです。
GAMEPOT連携以外のコンソールの使用方法は、次をご参照ください。

• ONE Storeガイド文書
• ONE store Developers Console: https://dev.onestore.co.kr/

コンソールに In-App商品を追加

1. ONE store developer centerにアクセス > APPS > プロジェクを選択 > In-App情報 > 管理商品 > [In-App商品を登録] ボタンをクリックします。
   

2. In-App商品情報を入力し、 [保存] ボタンをクリックします。
   

   • In-App ID: In-App固有の ID(product id)
   • In-App商品のタイトル: In-App商品名(ユーザー表示される名称)
   • In-App商品の種類: GAMEPOT SDKでは「管理商品」タイプのみサポートしているので、必ず「管理商品」を選択
   • In-Appの基本価格: 韓国ウォン基準で VAT込みの価格を入力

決済テスター追加の適用

1. ONE store developer centerにアクセス > APPS > プロジェクを選択 > In-App情報 > 決済テストをクリックします。

2. テスト IDの照会: 決済テストを行う ONE Storeのアカウント(メール情報)を入力し、 [照会] ボタンをクリックします。

   • ONE Storeのアカウントが照会されると、下部の「テスト IDの照会結果」部分が表示されます。

3. 照会された結果から決済環境を「sandboxまたは常用決済」にして登録します。

   • In-App商品の追加後、初回のテスト時は sandbox環境に設定します。
     

GAMEPOTダッシュボードにストア情報を登録

1. GAMEPOTダッシュボード > プロジェクトの設定 > ストア > ONE Storeメニューを順にクリックします。
   

2. ストア登録時に必要な情報は、In-App情報 > 管理商品 > In-App APIの管理 で確認します。
   

   • Server Key: ライセンスキーを入力
   • Client ID: Oauth認証情報の Client IDを入力
   • Client Secret: Oauth認証情報の Client Secretを入力

GAMEPOTダッシュボードの In-App商品を追加

GAMEPOTダッシュボード > 購入 > アプリ内購入 > [追加] ボタンをクリックします。

• 状態: 有効化状態で登録(使用しない商品は無効化)
• ストア: In-App登録対象のストアを選択
• 商品名: In-Appの商品名
• 商品 ID: ストアコンソールに入力した In-Appの ID(Product Id)

アプリの設定

Kotlin Gradleの設定

1. プロジェクトの settings.gradle.ktsファイルに以下の定義を追加します。

   dependencyResolutionManagement {
       repositories {
           ...
           google()
           // onestore repo
           maven(url = "https://repo.onestore.co.kr/repository/onestore-sdk-public")
       }
   }
   

2. プロジェクト(Module: app)の build.gradle.ktsファイルに SDK依存関係を追加します。

   dependencies {
   ...
       implementation("io.nbase:nbase-adapter-billing-one:3.0.1")
       implementation("com.onestorecorp.sdk:sdk-iap:21.01.00")
   }
   

3. AndroidManifest.xmlファイルに以下の queriesを追加します。

   <manifest>
       <queries>
           <intent>
               <action android:name="com.onestore.ipc.iap.IapService.ACTION" />
           </intent>
           <intent>
               <action android:name="android.intent.action.VIEW" />
               <data android:scheme="onestore" />
           </intent>
       </queries>
       ...
       <application>
           ...
       </application>
   </manifest>
   

Java Gradleの設定

1. プロジェクト(Module: project)の build.gradleファイルに以下の定義を追加します。

   allprojects {
       repositories {
           ...
           google()
           // onestore repo
           maven { url "https://repo.onestore.co.kr/repository/onestore-sdk-public"}
       }
   }
   

2. プロジェクト(Module: app)の build.gradleファイルに SDK依存関係を追加します。

   dependencies {
   ...
       implementation("io.nbase:nbase-adapter-billing-one:3.0.1")
       implementation("com.onestorecorp.sdk:sdk-iap:21.01.00")
   }
   

3. AndroidManifest.xmlファイルに以下の queriesを追加します。

   <manifest>
       <queries>
           <intent>
               <action android:name="com.onestore.ipc.iap.IapService.ACTION" />
           </intent>
           <intent>
               <action android:name="android.intent.action.VIEW" />
               <data android:scheme="onestore" />
           </intent>
       </queries>
       ...
       <application>
           ...
       </application>
   </manifest>
   

Unity Gradleの設定

1. /Assets/NBaseSDK/Editor/NBaseSDKDependencies.xmlファイルに以下の定義を追加します。

   <!-- # ONE Store -->
   <androidPackage spec="com.onestorecorp.sdk:sdk-iap:21.01.00"/>
       <repositories>
           <repository>https://repo.onestore.co.kr/repository/onestore-sdk-public</repository>
       </repositories>
   </androidPackage>
   <androidPackage spec="io.nbase:nbase-adapter-billing-one:3.0.1" />
   

2. Assets > External Dependency Manager > Android Resolver > Force Resolveを1回実行します。

3. プロジェクトの AndroidManifest.xmlファイルに以下の queriesを追加します。

   <manifest>
       <queries>
           <intent>
               <action android:name="com.onestore.ipc.iap.IapService.ACTION" />
           </intent>
           <intent>
               <action android:name="android.intent.action.VIEW" />
               <data android:scheme="onestore" />
           </intent>
       </queries>
       ...
       <application>
           ...
       </application>
   </manifest>
   

トラブルシューティング

Q. ONE Storeで決済しようとすると responseCode: 3, message: An error occurred during the purchase process. というエラーが発生します。
A. ONE Storeログインアカウントが決済テスターとして追加されているかご確認ください。

Q. 決済完了後にすぐ失敗が発生します。
A. サンドボックス環境での決済時、ダッシュボード > プロジェクト設定 > 一般 > Webフック項目内のホワイトリストパスから 購入/クーポン タイプで決済環境の IPアドレスを登録してください。
本番環境での決済時、購入/クーポン タイプで決済環境の IPアドレスが登録されていないことをご確認ください。