筹备全球分发

用词

• 国内ONE store：在韩国提供服务的ONE store

• 全球ONE store：在其他国家/地区国家提供服务的ONE store

ONE store服务构架

• 开发者只需在ONE store开发者中心注册一次商品，就可以在韩国和全球出售商品。

  • 在现有的韩国ONE store注册并出售商品的开发者，只需选择全球分发即可。

  • ONE store开发者中心通过 Re-Packaging开发者注册的App，为全球服务生成APK，并将其分发给全球ONE store用户。

• ONE store客户端和服务器分为韩国和全球。

  • 在App调用IAP SDK API时，将自动联动于与服务国家/地区相匹配的One Store客户端/服务器。

  • 开发公司服务器中调用IAP Server API时，须传送市场分类代码（x-market-code）。

  

ONE store Installer Infomation & 市场分类代码

分类	Installer Package Name	市场分类代码
韩国	com.skt.skaf.A000Z00040 com.kt.olleh.storefront com.lguplus.appstore	MKT_ONE
全球	com.onestorecorp.gaa.storeapp com.dti.folderlauncher	MKT_GLB

SDK

SDK 版本

• 要进行全球分发，需适用ONE store In-App支付 SDK V19（API V6）以上的版本。

• 如果使用SDK V17，需要升级SDK。

• 如果使用SDK V16，应新注册已适用SDK V21以上版本的App。

属于适用了检测App健全性网络安全解决方案的App时，需要适用修改了和网络安全解决方案不兼容问题的SDK.

• SDK V21.01 guides

联动ONE store客户端

联动商城

• 在韩国服务的ONE store和在其他国家/地区服务的ONE store的App是不是一体。

• 在韩国服务的App是韩国国内的ONE store，其他国家/地区服务的App必须联动于全球ONE store。

• 以往在ONE store中服务的V19以上App，可以直接在ONE store上进行全球分发，从而会自动联动于全球ONE store。

市场分类代码

• 如果向了解用户下载的市场分类代码的信息（国内ONE store或全球ONE store），则必须获取市场分类代码。

• 获取的市场分类代码，必须在使用服务器API时，需要确认正在使用的商城后发送到header中。

• 市场分类代码获取方法：

  • SDK V21 Guide​

服务器API

域名

• 全球服务域名不同于仅在韩国服务时的域名。

• 为了服务于全球，需要更改域名。

  • 仅在韩国服务时： ​https://apis.onestore.co.kr​

  • 服务于除韩国以外的国家/地区时：https://iap-apis.onestore.net​

市场分类代码

• Request header中已新增市场分类代码（x-market-code）。

• 如果在全球范围内提供服务，则必须在header中添加市场分类代码。

• 如果没有市场分类代码，会议韩国服务（默认值）来调用。

<示例>

curl --location '{global domain}/v7/apps/com.sample/purchases/inapp/products/{productId}/{purchaseToken}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {accessToken}' \
--header 'x-market-code: {marketCode}' \

市场分类代码	服务国家/地区
MKT_ONE	韩国
MKT_GLB	除韩国外

PNS

• PNS的国内ONE store和全球ONE store的消息推送地址不同。

• 因此，使用防火墙时，需要对每个推送地址，进行两次防火墙特殊处理。

外部支付

服务器API

• 外部支付API版本已更改为V6。

• 如果在除韩国外的国家/地区提供服务，则需要更改域名。

  • 仅在韩国服务时：https://apis.onestore.co.kr

  • 服务于韩国以外的国家/地区时：https://iap-apis.onestore.net

• 在外部支付购买明细传输API的Request Body中，新增了国家/地区信息和货币代码。

• 传输外部支付交易明细时，必须用已支付的货币和金额进行传输。

• 外部支付购买记录传输API已更新。（send3rdPartyPurchase-p1 ）

• 传输在美国产生的外部支付交易记录时，必须以send3rdPartyPurchase-p1 格式传输交易记录。

• 因现有格式不修改无法在美国以外国家/地区使用，预计2025年6月 deprecated，请适用新格式。

结算

• 注册ONE store开发者中心时，必须根据已注册的国为准，汇款服务使用费。

  • 如果会员国是韩国，要用韩币汇款。 （但美国销售部分，需以美元汇至当地服务提供商指定的专用账户。）

  • 如果会员国是其他国家/地区，需用USD汇款。 （但美国销售部分，需以美元汇至当地服务提供商指定的专用账户。）

• 服务使用费结算时的汇率，是销售月下一个月的1日的汇率。（以首尔外汇中介告示为准，如果1日是节假日时，则以前一工作日的汇率作为基准）。

商品

• 全球ONE store不提供定期付费商品。

• 即使存在现有定期付费商品，也不会分发到全球ONE store。

• 分发国家/地区及当地价格设置、多语言设置请参考 https://onestore-dev.gitbook.io/dev/v/eng/docs/apps