SuperAPI AI 工具集

harmonyos-iap-integration

编程与开发

查看项目

更新于 10-15 21:07

技能介绍

用途:为开发者提供 HarmonyOS IAP Kit 应用内支付的接入执行指南,帮助完成从联调到上线的闭环。适用任务包括设计或实现鸿蒙应用内支付、实现付费功能、排查掉单与重复发货、补单与订阅状态异常,以及制定沙盒联调和生产上线清单。

主要能力:覆盖消耗型商品(游戏币、钻石、体力等)、非消耗型商品(去广告、额外关卡、永久解锁等)、自动续期订阅(月度 VIP、年度会员、连续包月/季/年等)和非续期订阅(季卡、月卡、年卡等)四类商品。包含客户端与服务端完整实现、支付结果处理、防掉单机制、JWS 验签、关键事件通知等场景。

必要用法与标准流程:数字商品购买流程为环境检测 queryEnvironmentStatus → 查询商品信息 queryProducts → 服务器预下单 → createPurchase 发起购买拉起收银台 → 上报 PurchaseData → 服务器验签发放权益 → 端侧 finishPurchase 确认发货。补单流程为 queryPurchases 查询已购未确认发货的订单/订阅 → 上报 PurchaseData → 服务器验签发放权益 → finishPurchase。关键事件通知由 IAP 服务器发起,请求体形如 {"jwsNotification":"xxx"},需按通知类型处理业务并返回响应,涉及 DID_NEW_TRANSACTION 与 REVOKE 等通知类型。

前置准备:开启并激活应用内购买服务;在 module.json5 中配置 client_id;在商品管理系统中配置并上架商品(状态必须为在线);配置手动签名(不能用自动签名),指导文档 https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233 。

限制与注意:需按标准流程逐项检查,服务端验签时已退款订单(purchaseOrderRevocationReasonCode 不为空)不发放权益,已发放权益的订单不重复处理。常见错误码包括 1001860001(系统内部错误)、1001860002(应用未被授权)、1001860003(无效商品信息)、1001860004(接口访问过频,间隔默认 5s)、1001860005(网络异常)、1001860007(应用未在指定国家/地区上架)、1001860050(未登录华为账号)、1001860051(商品已拥有)、1001860057(非 debug 签名应用)、1001860058(非配置测试账号)等。官方开发指南:https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/iap-kit-guide ;端侧 API:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-arkts ;云端 API:https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-rest 。