为应用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