HarmonyOS鸿蒙Next中如何实现应用内支付零掉单？

HarmonyOS鸿蒙Next中如何实现应用内支付零掉单？ 在电子商务的快速发展中，用户体验成为了衡量平台服务质量的重要标准。当用户完成商品购买后，开发者需要及时发放相关权益。但在实际应用场景中，由于网络波动、进程被中止等异常因素，可能会出现支付状态无法及时确认的情况，从而无法及时发放权益，即出现"掉单"情况。

掉单不仅会严重影响用户支付体验，还可能引发退款、投诉等，容易产生负面舆情，从而增加开发者和运营人员额外的操作成本。

HarmonyOS SDK应用内支付服务（IAP Kit）为了确保权益发放，需要在以下2种场景检查用户是否存在已购未发货的商品，以防止掉单情况。

1.应用启动时。

2.购买请求（createPurchase）返回iap.IAPErrorCode.PRODUCT_OWNED或iap.IAPErrorCode.SYSTEM_ERROR时。

如果存在已购未发货商品，则发放相关权益，然后向IAP Kit确认发货，完成购买。

1. 应用客户端向IAP Kit发起queryPurchases请求，获取用户已购买但未确认发货的订单信息。
2. 在请求参数QueryPurchasesParameter中指定对应的productType，同时指定queryType为iap.PurchaseQueryType.UNFINISHED。当接口请求成功时，IAP Kit将返回一个QueryPurchaseResult对象，该对象包含承载了订单信息的PurchaseData的列表。
3. 对purchaseData.jwsPurchaseOrder进行解码验签。建议应用客户端将purchaseData发送至应用服务器，在应用服务器执行此操作。
4. 验证成功可得到对应的PurchaseOrderPayload的JSON字符串，如果PurchaseOrderPayload.purchaseOrderRevocationReasonCode为空，则代表购买成功，需要进行补发货处理。
5. 建议先检查此笔订单权益的发放状态，未发放则发放权益，成功后记录PurchaseOrderPayload等信息，用于后续检查权益发放状态。
6. 发货成功后，应用需调用finishPurchase接口确认发货，以此通知IAP服务器更新商品的发货状态，完成购买流程。
7. 发起请求时，需在请求参数FinishPurchaseParameter中携带PurchaseOrderPayload中的productType、purchaseToken、purchaseOrderId。

请求成功后，IAP服务器会将相应商品标记为已发货状态。对于消耗型商品，IAP服务器会将相应商品重新设置为可购买状态，用户即可再次购买该商品。对于非消耗型商品，用户购买后永久拥有，无法再次购买该商品。

用户在购买非消耗型商品后，将永久拥有该商品的权益。应用需要在用户购买非消耗型商品后，始终为其发放相关权益。

请在以下场景获取用户已购非消耗型商品的信息，并发放相关权益。

1. 应用启动时。

2. 购买请求（createPurchase）返回iap.IAPErrorCode.PRODUCT_OWNED或iap.IAPErrorCode.SYSTEM_ERROR时。

3. 应用客户端向IAP Kit发起queryPurchases请求，获取用户已购非消耗型商品的订单状态信息。

4. 在请求参数QueryPurchasesParameter中指定productType为iap.ProductType.NONCONSUMABLE，同时指定queryType为iap.PurchaseQueryType.CURRENT_ENTITLEMENT。当接口请求成功时，IAP Kit将返回一个QueryPurchaseResult对象，该对象包含承载了订单信息的PurchaseData的列表。

5. 对每个PurchaseData.jwsPurchaseOrder进行解码验签。

6. 验证成功可得到对应的PurchaseOrderPayload的JSON字符串，需要发放相关权益。

7. 发放权益后，应用需调用finishPurchase接口确认发货，以此通知IAP服务器更新商品的发货状态，完成购买流程。

8. 发起请求时，需在请求参数FinishPurchaseParameter中携带PurchaseOrderPayload中的productType、purchaseToken、purchaseOrderId。

请求成功后，IAP服务器会将相应商品标记为已发货。对于非消耗型商品，用户购买后永久拥有，无法再次购买该商品。

了解更多详情>>

访问应用内支付服务联盟官网

获取权益发放的开发指导文档