為套用ONE Store In-App支付做事前準備

商品註冊

登錄One Store開發者中心> APPS頁面,點擊App商品註冊按鈕後填寫App商品資訊。

註冊商品後,將收到應用軟件ID(AID)。

新建結算資訊

為了註冊並銷售收費商品(In-App商品),首先要新建结算資訊。

會員類型不同,需要輸入的資訊或需要提交的文件可能不同。有關開發者會員的詳細內容請猜考開發者指南裡的會員部分

  • 结算資訊:點擊開發者中心>會員資訊管理>會員資訊的结算資訊頁籤标签。

  • 企業會員在填寫結算資訊後,需要得到管理員的許可。

註冊In-App商品

可以在開發者中心> APPS > In-App資訊頁面註冊In-App商品。

In-App商品分為管理型商品和訂閱型商品。

管理型商品的逐个註冊

  • 在In-App資訊界面的管理商品選單中點擊"In-App商品注冊",填寫管理型商品資訊。

  • In-App ID:輸入該商品的In-App ID,檢查ID是否重複。In-App ID必須是應用軟件内唯一值。

  • In-App 商品名稱:輸入商品名稱。商品名稱會顯示在支付界面及購買訂單裡。

  • In-App 商品路徑:在應用軟件內可確認該In-App商品的路徑,不是必要值。相關資訊為One Store驗證部門驗證時使用。

  • In-App 商品價格:輸入In-App商品的銷售價格。請輸入包含附加税的金額。

填寫完畢後,點擊底部的"保存"按鈕。

管理型商品的批量註冊

  • step 1> 點擊"下載批量註冊表格"並進行下載。

  • step 2> 在下載的表格里輸入In-App商品資訊。

  • step 3> 點擊"商品批量註冊",上船填寫完In-App商品資訊的文件。

  • step 4> 確認所有In-App商品是否順利註冊。

下載的In-App商品批量註冊表格,最多只能填寫50個In-App商品。 需要註冊的商品超過50個時,請分為50個為一組填寫表格。

訂閱型商品的註冊

  • 在In-App資訊界面的訂閱商品選單中點擊"In-App商品註冊",填寫訂閱型商品資訊。

  • In-App ID:輸入該商品的In-App ID,檢查ID是否重複。In-App ID必須是應用軟件内唯一值。

  • 訂閱商品名稱:輸入商品名稱。商品名稱會顯示在支付界面及購買訂單裡。

  • 訂閱商品路徑:在應用軟件内可確認該In-App商品的路徑,不是必要值。相關資訊為One Store驗證部門驗證時使用。

  • 訂閱商品基本價格:輸入訂閱商品的基本銷售價格。請輸入包含附加税的金額。

  • 訂閱商品支付時間:選擇可以使用訂閱商品的時間即可。以所選期間為單位更新支付。

    • 每周/每月/3個月/6個月/每年

每月支付的商品,下一个月的同一天為支付日(3個月/6個月支付的商品同理)。 例如,如果1月15日開始定期支付,下一個支付日是2月15日。 但,如果沒有相同的日期,當月的最後一天就是支付更新日。 例如,1月31日開始定期支付,下一个支付日是2月28日(或29日),再下一個支付日是3月28日(或29日)。

  • 免費訂閱期間:提供免費訂閱期間,顧客可以體驗相關訂閱商品後决定是否使用訂閱。同一顧客同一商品不能提供1次以上的免費訂閱。

  • 新折扣促銷價格:可以選擇新折扣促銷價格和商品使用時間。新折扣促銷價格不能高於訂閱商品的基本價格。

新折扣促銷支付時間訂閱商品的支付時間。

例如,以每月支付的訂閱商品為例,如果設定的支付時間為3,顧客將在3次支付期間(3個月)享受優惠的價格。

  • 支付寬限期:如果支付手段出現問題,可以决定是否向顧客提供寬限期。如果提供寬限期,顧客在寬限期內可以正常使用内容。

支付手段出現問題時,即使不設定支付寬限期,也不會立即解除訂閱。用戶的帳戶處於保留狀態,在保留狀態下解决支付問題後,重新進行定期支付。

  • 填寫完畢後,點擊底部的"保存"按鈕。

訂閱型商品設置管理

  • 在訂閱商品選單中按下訂閱商品設置管理按鈕。

  • 在該選單上可以設置暫停訂閱及是否免費使用各訂閱商品。

  • 暫停訂閱及是否免費使用各訂閱商品,適用於所有訂閱商品。

確認許可證密鑰(Public Key)及OAuth認證資訊

點擊One Store開發者中心>Apps > In-App資訊 > "In-App API管理",即可確認許可證密鑰和進行伺服器API的OAuth認證資訊。

  • 許可證密鑰:用於確認One Store傳遞的In-App支付訂單是否存在偽造和篡改。

  • OAuth認證資訊:為了使用One Store 伺服器API而進行的認證。

下載Sample軟件

可以在Github下載In-App支付的Sample軟件。

添加In-App支付library

在Project最上面build.gradle文件中註冊One store maven地址。


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

以下是在應用軟件的build.gradle 文件中添加One store支付library從屬項目。


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

安裝ONE store應用軟件

開發者或用戶使用One Store In-App支付時,需要安裝One store(ONE store Service, OSS)軟件。 韓國國內運營商(SKT、KT、U+)定制推出的Android智能手機上内建了One store服務,但海外上市的智能手機(Pixel等)或平板電腦上沒有安裝One store軟件。 根據開發One store In-App支付模塊的智能手機情况,需要使用以下指南下載One Store服務,使其達到最新狀態。

  • 韓國國內運營商推出的智能手機 韓國營運商推出的Android智能手機基本自帶One Store軟件。開發者可利用手機自帶的One store(ONE store client, OSC)軟件將其升級為最新版本。 運行安裝在智能手機上的One store(或T Store/ Olleh Market/ U+ Store),更新One store客戶端和One store服務即可。(注意:老款智能手機可能不能支持自動更新。)

  • 面向海外市場的智能手機、平板電腦及制造商分銷終端 針對海外市場的智能手機及平板點腦、制造商分銷終端,由於沒有安裝One store軟件,需要下載並安裝One store用戶端和One store服務。 請點擊以下鏈結,安裝開發In-App支付所需的One store應用軟件(只能在手機上打開)。 去下載One store用戶端和服務

ONE store In-App支付 API V6(SDK V19)只能在Android OS版本4.1以上的安卓設備上啟動。 聯動In-App支付模塊前請確認智能手機的OS版本。

Last updated