HarmonyOSNext 支付全栈攻略：IAP Kit 无漏单秘籍+避坑指南
##Harmony OS Next ##Ark Ts ##教育
本文适用于教育科普行业进行学习，有错误之处请指出我会修改。
🎯 一、搞懂应用内购买基础逻辑用户买买买只有两种姿势👉：
消耗型商品：像游戏金币💎，用完得再买
非消耗型：永久会员🔑，一次购买终身持有
📝 关键准备工作：在开发前必须去华为后台配置商品！否则收银台会寂寞如雪❄️
🔥 二、促销优惠这样玩更吸睛华为 IAP 支持精准撒券能力：
🪄 魔法配置项：1. 指定用户群：学生党👩🎓/新用户🎁2. 地域限制：仅限北上广深📍3. 次数自由：想搞几次搞几次！
复制代码
⚠️ 特别注意：
🛡️ 需服务器生成优惠签名，纯客户端搞不定！推荐用华为云函数省事~✅ 优惠次数无上限，但别把用户宠坏呀！
🛒 三、完整购买全流程拆解
阶段 1️⃣：商品展示
// 检查环境是否支持支付import { iap } from '@kit.IAPKit';
queryEnvironmentStatus() { iap.queryEnvironmentStatus(context).then(() => { console.info('环境检查通过🎉'); }).catch((err) => { console.error(`完蛋！环境不支持: ${err.message}😱`); // 赶紧隐藏支付按钮！ });}
复制代码
✅ 操作指南表：
阶段 2️⃣：下单支付
// 用户点击购买按钮时createPurchase() { iap.createPurchase(context, { productType: iap.ProductType.CONSUMABLE, productId: 'ohos_diamond_50' // 换成你的商品ID }).then((result) => { this.dealPurchaseResult(result); // 处理成功 }).catch((err) => { console.error(`支付失败！错误码: ${err.code}💥`); })}
复制代码
💡 黄金提示：
调用太频繁会触发风控！1 秒内别超 3 次，否则报错1001860004
阶段 3️⃣：处理结果
🔔 两种姿势收结果：
举个栗子🌰（服务端方案）：
// 服务端验签核心代码const jwsPurchaseOrder = NotificationPayload.jws;if (verifySignature(jwsPurchaseOrder)) { // 自己实现验签 grantVIP(); // 发放权益！}
复制代码
📦 四、发货避坑指南
关键动作：finishPurchase()
// 必须发货成功才能调用！finishPurchase(payload) { iap.finishPurchase(context, { purchaseToken: payload.token, // 订单身份证 purchaseOrderId: payload.id // 订单号 }).then(() => { console.info('发货成功🚚'); })}
复制代码
💥 血泪教训：
⚠️ 顺序错乱会出大事！❌ 错误姿势：先调用 finish 再发货 → 用户没收到货但钱扣了！✅ 正确姿势：数据库记录发货状态后再 finish
🆘 五、补发救援方案
出现这些情况要抢救：
dealPurchaseError(err) { if (err.code == iap.IAPErrorCode.PRODUCT_OWNED) { emergencyReissue(); // 紧急补货！ }}
复制代码
补发全流程：
graph TD A[应用启动] --> B{检查未发货订单} B -->|有漏单| C[queryPurchases] C --> D[验签解码] D --> E[发放权益] E --> F[finishPurchase]
复制代码
经典场景处理表：
🛠️ 六、单机应用专属方案非消耗品要这样玩：
// 查询永久权益queryPurchases({ productType: ProductType.NONCONSUMABLE, queryType: PurchaseQueryType.CURRENT_ENTITLEMENT })
// 检测到权益直接解锁功能unlockFeature(payload.productId);
复制代码
✨ 偷懒技巧：本地存储购买凭证，即使没网络也能恢复权益！
🚨 终极避坑清单
最后唠叨一句💬：测试阶段务必用沙盒环境！别用真钱测试，否则财务小姐姐会追杀你哟~ 👻
评论