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);

✨ 偷懒技巧：
本地存储购买凭证，即使没网络也能恢复权益！

🚨 终极避坑清单

最后唠叨一句💬：
​​测试阶段务必用沙盒环境​​！别用真钱测试，否则财务小姐姐会追杀你哟~ 👻