华为 HMS Core应用内支付服务(In-App Purchases,IAP)为应用提供便捷的应用内支付体验和简便的接入流程。该服务支持客户端和服务端两种开发形式,具体可以参考官方文档。 往期文章:常见问题总结(2)中分享总结了有关无法拉起支付页面的常见问题,本文将对近期开发者们较为关注的一些集成应用内支付服务过程中的问题进行汇总,并提出解决方案。 问题 1:开发者联盟支付卡片中的支付公钥(路径:开发者联盟>管理中心>支付>获取支付信息)和应用内支付中配置的公钥(路径:打开项目 >左侧导航栏“盈利 > 应用内支付服务”)有什么区别吗?
问题根因:
为了防止返回结果被篡改,提高安全性和可靠性,支付结果必须要对签名字符串使用 IAP 公钥进行验签,由于 VR 支付目前还使用 2.0 的支付接口,所以仍然会使用开发者联盟支付卡片中的支付公钥。
应用内支付中配置的公钥(路径:打开项目 >左侧导航栏“盈利 > 应用内支付服务”,若“IAP”页签显示未生成 IAP 支付公钥,点击“设置”生成 IAP 支付公钥。)主要用于 4.0 的支付接口,而 4.0 的接口是目前常用接口。
问题 2:华为应用内支付回调请求为空,没有任何有效用户信息。
问题背景:
用户订阅了会员包年,但后台没有自动发货,点击了订单中的【补发】按钮,重新发起了支付回调,但数据无效,然后开发者 CP 改成了测试接口,打印出了所有华为支付回调的请求内容,发现请求正文为空字符串,没有任何有效用户信息。
“我是在支付报表点击的补单按钮。移动端接入的 HMS 版本是 6.4.0.301。你说 HMS4.0 的订单,我们不会收到支付成功回调,但我这边点补发收到了一个空白回调,这是正常的吗?另外,我们的订阅回调接口之前是发生异常也返回 200,所以可能在华为 IAP 服务器这边认为应用方已经发货了,这种情况,用户客户端再启动应用还能触发补单吗?”
原因分析:
根据官方的 FAQ 文档,对于 HMS4.0 订单,点击补发,触发华为支付服务器向华为 IAP 服务器发送支付成功回调,您不会接到支付成功回调。
在支付报表点击的补单按钮,收不到支付成功的回调通知,如果点击补发,收到一个消息体为空的的回调,并不能作为依据对问题进行分析定位,所以可以忽略。
解决方案:
补单分为客户端补单和服务端补单,只有消耗性商品才有补单流程,客户端补单需要您在客户端中触发补单,比如应用启动的时候;如果有异常,会返回返回 -1,60051,1 等错误码场景,从而需要触发补单机制;具体可以参考文档。 对于订阅型商品,一般我们使用的是订阅关键事件的通知,请参考文档。 关于订阅回调接口之前是发生异常时也返回 200,可能在华为 IAP 服务器这边认为应用方已经发货了的情况,不存在这种情况,如果有这种情况,请提供对应的订单号,我们将对该订单进行分析。
问题 3:我 9 月份提交的结算申请,现在还没到账,请问收益结算什么时候到账?
问题背景:
CP 反馈 9 月份提交的结算申请,结算单中的结算状态显示都是在"付款中",但是现在还没到账,不知道具体是卡在什么地方。
原因分析:
根据官方文档,如对结算数据无异议,点击“确认结算单”提交结算申请,并核对申付金额及收款银行等信息无误后,点击“提交”,提交后将无法取消。如需多个结算单合并开票,请确认同一个合同、同一业务类型相同的结算单方可进行合并开票。
解决方案:
也就是说,只要确认结算单了,付款状态都是在付款中,但是 CP 需要先开票(也可以合并开票)才能结算,按照确认的结算单金额开具发票,合并开票需将所选结算单中的“结算汇总信息 - 结算金额”加总,注意金额与发票金额要完全一致,不能有差异。
具体详情请您参考开发者联盟关于自主结算指南的官方文档进行相关操作。 4. 联盟官方文档,AppGallery 站点老域名以及使用的加密套件将会逐渐下线,是否有更详细的操作文档可供开发者参考?
问题背景:
根据官方文档说明,为了增强您的应用的安全性和可靠性,HUAWEI IAP 更新了 URL,并提高了对 TLS 版本和密码套件的要求。出于安全考虑,从 2023 年 4 月起,HUAWEI IAP 将不再支持 1.2 以下的 TLS 版本和规定之外的加密套件支持。AppGallery 站点使用的老域名后续也会下线。
解决方案:
目前暂时没有相关指导文档,这些是标准的网络套件和协议,但是可以参考官方发布的服务器多语言演示 demo。
替换域名的具体操作请参见官方示例代码,将对应区域的旧域名替换为最新的域名。例如,需要上架中国站点 APPGallery 应用市场,Order 服务验证购买 token 接口需要将之前的 https://orders-at-dre.iap.dbankcloud.com 替换为中国站点:https://orders-drcn.iap.cloud.huawei.com.cn 。
5. 华为订阅返回数据中的 expirationDate 字段,和用户到期后下次扣费的时间是一致的吗?
问题背景:
“我想问一下华为订阅返回数据中 expirationDate 字段,和用户到期后下次扣费的时间是一致的吗? 用户 2021 年 12 月 5 日付费年订阅产品,实际于 2022 年 12 月 4 日进行了自动续费扣款,但是华为在 2021 年支付成功后返回的字所 expirationDate,转换时间戳后是 2022 年 12 月 8 日到期,请问是华为针对订阅产品会提前扣费吗? 还是 expirationDate 并不等同于下次扣款时间 ? 如果需要知道精确的下次扣款时间, 应该取什么字段呢?”
原因分析:
如下是官方文档对 InAppPurchaseData 中的 expirationDate 字段的解释说明:
根据 IAP 的的扣费规则,会提前 24 小时开始尝试扣费,用户是在 2021 年 12 月 5 日付费年订阅产品到期,那么在订阅周期结束前 24 小时,即 12 月 4 号扣费是没有问题的,华为 IAP 会尝试向用户发起扣款以完成订阅型商品的续期。若扣费失败,华为 IAP 会在一定期限内重复尝试扣费,若失败次数过多,最终会停止重试。
解决方案:
expirationDate 字段并不等同于下次扣款时间,而是当前订阅的过期时间,IAP 支付服务器当前没有返回下次扣款时间,也不会有精准的扣款时间,一般都是显示订阅的续期时间或者会比续期时间稍长,但是不会相差很大。
如果订阅的续期时间和实际显示的 expirationDate 相差很大,需要 CP 提供订单号或者订阅 id 等数据进
了解更多详情>>
关注我们,第一时间了解 HMS Core 最新技术资讯~