IAP应用内支付FAQ

游戏技术分享

已于 2025-05-09 16:22:16 修改

阅读量626

点赞数 8

分类专栏：鸿蒙游戏-华为SDK接入与上架文章标签：鸿蒙 harmonyos 华为游戏应用内支付

于 2025-04-24 19:38:22 首次发布

本文链接：https://blog.csdn.net/2401_82404985/article/details/147490684

版权

鸿蒙游戏-华为SDK接入与上架专栏收录该内容

4 篇文章

订阅专栏

1 开发准备

应用内支付回调地址是应用级还是开发者级？为什么在回调地址由正确修改为错误后，依然会收到正确地址的回调？

IAP应用内支付的回调地址是应用级别的。
回调地址生效有缓存时间，大概10分钟，可以通过多次拉起购买弹窗来推动地址生效。

若游戏在调试应用下面没有配置回调地址，在正式游戏的应用下面配置了，但是调试应用也可以收到关键事件通知，需要如何处理？

主要检查商品定义在哪个应用下面，即下单时属于哪个APP ID。
若已在AGC控制台开通应用内支付服务，那么之前的配置还会保留，需要尽快激活应用内购买服务，激活后可以调整配置。

参考资料：

激活应用内购买

后台配置了服务端事件通知的地址，客户端也做了订阅下单和续签的操作，但服务端一直没收到回调是什么原因？

按照应用内支付服务的开发准备文档检查。
检查APP ID和Client ID是否与AppGallery Connect应用下的匹配。
检查通知地址是否为v3版本。
检查通知地址是否正常可用，是否会拦截不固定IP的回调。

在实际项目中，IAP应用内支付的工程是直接在客户端使用JWTUtil中解码？还是需要将PurchaseData传到服务端后，下载HUAWEI CBG Root CA G2根证书去解码验签呢？

从安全系数方面看，将PurchaseData传到服务器这个方案更好。根据安全性需求进行配置，这里推荐高安全系数的支付验证，IAP应用内支付的官网文档上有详细的商品购买验签流程。更多内容请参考接入购买。

开启订单订阅关键事件通知，通知服务版本选择v2版本之后，提示刷新失败，需要如何处理？

通知服务版本应当选择v3版本，不支持v2版本。

没有拉起IAP应用内支付页面，可能的原因有哪些？

检查应用签名是否为手动签名。
检查工程配置的APP ID和Client ID是否正确。
是否添加了证书指纹和公钥指纹。
检查工程中的包名是否一致。
应用的支付服务开关是否打开。
激活服务和配置事件通知审批是否通过。

处理步骤：

请参考配置应用身份信息、添加公钥指纹章节进行检查。
请参考配置签名信息检查是否使用了自动签名方式，请使用手动签名方式。
需要使用华为应用内支付功能的应用必须开启和激活应用内购买服务。

2 关键字段

订单状态查询接口中的purchaseOrderId的字段长度是多少？

purchaseOrderId推荐256存储，purchaseOrderId字段长度是32，但是字段长度是有可能变长的，不建议以当前的32为上限。

订单状态查询接口中的purchaseOrderToken的字段长度是多少？

purchaseOrderToken是用于唯一标识商品和用户对应关系的购买令牌，在支付完成时由IAP应用内支付服务器生成。当前92位，后续存在扩展可能。

如要进行存储，建议预留128位的长度。为保证安全，建议加密存储。

在退款场景中，revocationTime字段的单位是什么？

属于PurchaseOrderPayload订单信息模型中的字段，是退款场景下返回的revocationTime购买订单撤销时间，UTC时间戳，以毫秒为单位。更多内容请参考数据类型说明。

developerPayload字段表示什么？游戏开发者需要在何时传入？何时返回给华为侧？

属于InAppPurchaseData购买数据模型中的字段，developerPayload字段表示商户侧保留信息，为透传字段，由开发者在调用支付接口时传入，在用户支付的时候需要游戏侧返回给华为侧，支付成功后向华为侧请示订单详情时，华为侧会原样返回传递的字段值。更多内容请参考数据类型说明。

SubscriptionStatus订阅状态信息里的subscriptionId字段和lastPurchaseOrder里的subscriptionId是不是一致的？

lastPurchaseOrder里面的subscriptionId跟SubscriptionStatus里面的subscriptionId是一致的，但这个ID在用户切换订阅商品时会发生改变，此时，lastPurchaseOrder也会更新，所以两个subscriptionId一直是匹配的。

IAP应用内支付中JWT Payload的Issuer ID和密钥是开发者级别的吗？Issuer ID和密钥等商户级参数是HarmonyOS NEXT、华为、车机共用的还是分开的？支付服务的私钥参数除第一次下载外，是否有其他办法获取？

IAP应用内支付中JWT Payload的Issuer ID和密钥是开发者级别的，在初次生成密钥时，服务器将为商户自动生成唯一一个Issuer ID，一个Issuer ID最多拥有10个密钥，每个私钥生成的jwt，都需要在华为服务器进行校验，可以跨应用使用。
密钥在同一个商户下是共享的，一个密钥可以对应多个应用，对于大量应用的开发者，可以多个应用间复用同个密钥。
IAP应用内支付服务器将为商户生成唯一的Issuer ID，涵盖所有应用。
私钥仅供下载一次，下载后的私钥需要开发者安全保存，可以重生成一个。

参考资料：

3 关键接口

调用订单状态查询接口报错responseCode: 1001880006,responseMessage: rights invalid.需要如何处理？

需要查看订单ID，这个问题大概率是APP ID的问题，检查一下订单ID，APP ID更换后那么订单ID也必须是更换之后的应用下，对应订单产生的ID。

调用获取订单接口报错responseCode: 1001880006,responseMessage: failed to get merchant key Error : Failed to get the key info.需要如何处理？

这个报错不是私钥获取的问题，私钥错误或者格式有误，IAP应用内支付服务器会报验签失败的错误。可能是issId、kId和私钥三者不匹配，需要检查issId/kId/私钥三个参数是否配置正确。

调用订单状态查询REST接口报错responseCode: 1001880006,responserMessage: Failed to verify the digest.需要如何处理？

可能原因：

签名内body请求的hash值与签名内digest的不一致。
排查方式：

获取JWT，解码其中payload的digest，检查是否一致。更多内容请参考生成服务端请求的token。

调用订单状态查询接口报错responseCode: 1001880006,responseMessage: parameter is not valid，是什么原因？

purchaseOrderId/purchaseToken有误，属于非法输入参数导致报错。

调用查询订单状态接口返回responseCode:1001880006,responseMessage: JWT verification failed.需要怎么处理？

验签时失败了，使用了非法签名，需要检查生成签名时的算法，jwt.io官网上校验时需要使用ES256算法。

调用获取订单接口报错responseMessage: failed to get merchant key Error : Failed to get the key info.需要怎么处理？

JWT的参数配置错误，重点查看是不是和kId和IssId参数配置错误，如果是参数类型不对，或者为空，会提前校验到。

已发货的订单无法再查询订单信息，订单查询接口返回record does not exist，无法区分订单不存在还是已发货，需要怎么处理？

由于隐私要求，无法查询已发货的订单信息。根据响应消息来区分订单，已发货的订单在响应消息里返回“Record does not exist”，不存在的订单返回“invalid paymentToken，not found correspond order”。

订阅型商品购买后消耗订单，再次购买，报错1001860051，需要怎么处理？

订阅型和非消耗型不可重复购买，订阅型商品需要iap.showManagedSubscriptions取消订阅后再次尝试。

消耗型商品发起购买，报错1001860001，支付界面反馈“查询失败，请稍后重试”，是什么原因？

可能是因为付款账户可用余额不足，后续会对该场景作出提示优化，请确保付款账户余额充足。
检查Client ID 或 APP ID 是否正确配置。
需要手动签名，不能使用自动签名。

iap.queryProducts接口报错1001860005: Network connection error，但其他支付接口不会报错，必现问题，需要如何处理？

获取在AppGallery Connect上配置的商品的详情信息，每次只能查询一种商品类型的商品，每次最多查询200个商品，否则请求将报错。

在获取商品信息的时候，报错responseCode: 1001860001, responseMessage: Get distributionAppId failed, 是什么原因？

未在AppGallery Connect后台打开应用内支付服务的开关，在“AppGallery Connect> API管理 > 应用内支付服务”打开应用内支付的开关，。

IAP应用内支付云端接口错误码：1001880010，1001880011。在什么情况下会触发？

1001880010是用户账号高风险，操作被拒绝的时候触发，1001880011是用户账号异常，比如已经销户时触发。需要更换账号或重新注册。

在确定订单发货之后，调用queryPurchase接口时订单状态信息仍可查询到，与预期报错误结果不符合，是什么原因？

如果开发者调用的是端侧的权益发放queryPurchases接口，校验是否已发货是可以查到所有历史订单的。

订单确认发货（消耗性/非消耗型商品）和订单状态查询这两个接口调用失败的错误码有哪些？

详情请参考REST API错误码。

所有商品购买都需要调用finishPurchase接口吗？若游戏支付时没有调用finishPurchase接口，会有什么影响？调用失败是否影响商品购买？

所有类型的商品必须调用finishPurchase接口才可以完成购买。
需要调用确认发货接口将订单消耗掉，成功执行finishPurchase之后，IAP应用内支付服务器会将相应商品标记为已发货状态，如果没有调用finishPurchase接口将无法完成购买。
消耗型商品若没有调用finishPurchase接口则下一笔订单无法购买；非消耗型商品只能购买一次，购买后终生有效的，不能再次购买；自动续期商品则根据是否在商品有效期内购买的，建议最后都调用finishPurchase接口完成购买流程。