游戏行业 IAP 解决方案 #

接入准备 #

明确投放国家 #

建议商户在我们推荐的国家列表投放游戏内购（IAP），优先选择本地主流支付方式（本地电子钱包，运营商钱包，本地卡，本地银行转账等）。针对没有覆盖本地支付方式的国家，平台提供国际信用卡 VISA/MASTER 支付。

IAP 研发指引 #

1. 适配支付方式：针对目标国家的不同支付方式，研发团队需要重点关注应用内支付收银台加载模式并进行适配。
2. 支付预下单/创建订单：若商户在多个业务开展国投放流量，支付预下单统一使用美金计价：
   • countryCode = 用户所在真实国家
   • currency = USD
   • PayByLocalCurrency = true 平台会根据用户所在国家 countryCode 自动进行货币转化。给用户在支付收银台上展示本位币金额。
3. 游戏购物车中 SKU 标价统一策略：
   • 使用汇率转换 API。
   • SKU 标价的本位币金额向上取整，可以显著减少美元汇率带来的价格波动。
   • SKU 标价涉及的国家 - 币种对应关系（用户所在业务开展国 CN，对应国家币种是 CNY）目前需要业务方自行在其服务端进行维护，可以访问国家币种对照表获取。
4. 横竖屏模式切换：针对横屏游戏，商户需要根据所使用的引擎去实现横竖屏切换，强制展示“竖屏收银台”。
5. 游戏 APP 发起预下单成功后，默认在应用内用 webview 加载支付 H5 收银台（webUrl），请避免外跳手机浏览器打开支付收银台（外跳会降低支付收银台下单转化率），可以根据文档指引完成 webview 授权。
6. 若用户在购买的过程中主动关闭内购 webview 页面回到游戏，客户端不能直接认定为支付失败，需将其作为“交易进行中”处理，这笔交易的最终结果客户端应该从游戏的服务端获取。
7. 为了减少游戏内支付页面的调整次数，建议游戏方客户端监听我方的“支付结果页地址”。如果跳转到这个页面了，贵方可以关闭支付页面回游戏。使得游戏内购的体验就更丝滑，和国内钱包支付体验相似。
   • 支付结果页地址（固定地址）：https://cashier-serverweb.paynicorn.com/result
8. 进入场测环节前需将支付应用切换成生产模式。

业务开展国和支付方式 #