三.苹果支付 - 漏单补单处理

2024-06-17 16:28

本文主要是介绍三.苹果支付 - 漏单补单处理,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

介绍

苹果的支付流程并不复杂,我们可以在很短的时间内实现正常的支付流程。

但是苹果支付有一个很大特点就是慢,包括唤起支付弹窗,点击完成到服务端验单完成,整个流程很长,任何一个环节都有可能因为断网,或者退出APP导致支付流程中断。

一旦用户输入的支付密码,但是支付流程没有进行完成,这个时候就产生了漏单的情况,也就是说扣了用户的费用,但是购买的东西没有发放到账户。

本篇博客就来介绍苹果支付的漏单处理方案。

支付流程

上面提到任何环节出现中断,都会产生漏单,那么我们就需要清楚整个支付流程分成那几个阶段。

1.发起购买:

通常完整的支付流程,都会拿到用户选择的商品到服务端生成一个预备订单。生成订单完成之后会返回一个订单id preorderId。(这些和自己产品的业务需求相关,每个服务端实现的方案可能不都一样),拿到订单id preorderId,发起苹果支付,商品被添加到购买列表。

2.输入密码:

商品被添加到列表后,会弹出支付弹窗要求用户输入支付密码。

3.支付完成:

用户输入完支付密码之后,提示支付成功,弹窗消失,根据网络情况会在几秒内弹出购买成功的弹窗。

4.服务端验单:

点击购买完成的OK按钮,进入购买完成状态,发起验单请求。

5.购买完成:

验单通过,完成购买流程。

漏单情况

在用户没有输入密码之前取消支付操作,或者其它原因中断支付操作,因为没有进行付款,所以我们可以直接销单,这都没有问题。

但是一旦用户已经输入了密码,也就是从第3步以及以后的步骤,发生了网络中断,或APP退出,那么都算是发生了漏单。

支付过程中我们可以通过paymentQueue方法来监听支付流程和支付结果

    //MARK: 购买结果 监听回调func paymentQueue(_ queue: SKPaymentQueue, updatedTransactions transactions: [SKPaymentTransaction]) {for tran in transactions {switch tran.transactionState {case .purchased://购买完成CSLog.info(module: "apple pay", "购买完成")completePay(transaction: tran)breakcase.purchasing://商品添加进列表CSLog.info(module: "apple pay", "商品添加到列表")breakcase.restored://已经购买过该商品SKPaymentQueue.default().finishTransaction(tran)CSLog.info(module: "apple pay", "pay success 1,productId=\(self.proId ?? "")")self.resultBlock?(true,nil,"已经购买过该商品")breakcase.failed://购买失败SKPaymentQueue.default().finishTransaction(tran)CSLog.info(module: "apple pay", "pay failed 4,productId=\(self.proId ?? ""),error=\(String(describing: tran.error))")self.resultBlock?(false,tran.error,"购买失败")breakdefault:break}}}

发起支付,商品被添加到列表的时候会进入该代理方法,并且有一个transactionState == .purchasing状态的SKPaymentTransaction。

当用户输入密码完成之后并不会调用这个代理,而是当用户看见完成购买的弹窗并点击OK时,才会再次进入该代理方法,并且 transactionState == .purchased,此时我们去服务端进行验单。

那么产生漏单就有两种情况:

  1. 当用户输入密码但是没有看见完成的弹窗,或者没有点击OK,直接退出APP。
  2. 还有用户点击OK但是当还没有进行服务端验单,或验单未完成,直接退出APP。

漏单处理

既然已经清楚了漏单的具体情况,那么我们就来着手处理这两种情况。

  • 仅剩服务端未处理

先来看比较简单的情况,用户点击OK,但是服务端验单未完成。

购买成功

上面已经提到,当用户点击OK之后会进入代理方法,并且transactionState == .purchased,此时我们认为支付已经完成,开始验单。

    //MARK: 购买成功验证凭证func completePay(transaction:SKPaymentTransaction) {//获取交易凭证if let base64Str = self.getRecepitStr(transaction: transaction) {if let product = self.product {guard let productId = product.productId else { return }guard let amount = product.showAmount else { return }guard let currency = product.currency else { return }guard let preorderId = preorderId else { return }guard let transactionId = transaction.transactionIdentifier else { return }// 服务端校验verifyReceipt(productId: productId, preorderId: preorderId, amount: amount, currency: currency, receipt: base64Str, transactionId: transactionId, transaction: transaction)}}}
服务端校验

可以看见本次业务中验单需要的数据有很多,但无论有什么数据,处理起来都是一样的,当我们获取到购买成功之后,将验单所需的所有数据保存一份到本地。

    ///校验凭证///- Parameters:///   - productId: 商品id///   - preorderId: 订单id///   - amount: 金额///   - currency: 货币类型///   - receipt: 凭证///   - transactionId: 交易idfunc verifyReceipt(productId:String,preorderId:String,amount:String,currency:String,receipt:String,transactionId:String,transaction:SKPaymentTransaction) {if presenter == nil {presenter = CSWalletPresenter()}// 保存self.saveReciptInfo(productId: productId, receipt: receipt, preorderId: preorderId, amount: amount, currency: currency, transactionId: transactionId)presenter?.requestApplePayReceipt(productId: productId,preorderId: preorderId, amount: amount, currency: currency, receipt: receipt, adid: "", transactionId: transactionId, extParamater: ["":""]) {[weak self] success,error inguard let self = self else { return }if success {SKPaymentQueue.default().finishTransaction(transaction)// 清除AppPayManager.shareInstance.removeReciptInfo()self.resultBlock?(true,nil,"支付成功")} else {self.resultBlock?(false,error,"支付失败")}}}
保存数据

保存数据的代码如下:

    /// 保存交易凭证,订单,及其它商品信息/// - Parameters:///  - productId: 商品id///  - receipt: 交易凭证///  - preorderId: 订单id///  - amount: 金额///  - currency: 货币///  - transactionId: 交易idfunc saveReciptInfo(productId:String? = nil,receipt:String? = nil,preorderId:String? = nil,amount:String? = nil,currency:String? = nil,transactionId:String? = nil) {CSLog.info(module: "apple pay", "存储交易凭证")let userDefault = UserDefaults.standardlet uid = CSAccountManager.shared.account?.user?.id ?? 0let dict = userDefault.dictionary(forKey: "\(uid)-receiptInfo")let dictM = NSMutableDictionary.init(dictionary: dict ?? [:])if productId != nil {dictM["productId"] = productId}if receipt != nil {dictM["receipt"] = receipt}if preorderId != nil {dictM["preorderId"] = preorderId}if amount != nil {dictM["amount"] = amount}if currency != nil {dictM["currency"] = currency}if transactionId != nil {dictM["transactionId"] = transactionId}userDefault.set(dictM, forKey: "\(uid)-receiptInfo")userDefault.synchronize()}

这里根据用户的uid存储了用户收据到userdefault中,是为了避免验单到其他用户,将金币加给其他用户。

清除数据

如果这订单校验完成,那么清除掉收据信息,清除的代码如下:

    //MARK: 移除交易凭证,订单,及其它商品信息func removeReciptInfo() {CSLog.info(module: "apple pay", "移除交易凭证")let userDefault = UserDefaults.standardlet uid = CSAccountManager.shared.account?.user?.id ?? 0userDefault.removeObject(forKey: "\(uid)-receiptInfo")userDefault.synchronize()}
开启漏单检测

在启动时AppDelegate中进行漏单检测:

        // 进行漏单检测AppPayManager.shareInstance.validateReceipt()

检测代码如下:

    //MARK: 漏单检测func validateReceipt(transaction:SKPaymentTransaction? = nil) {//获取交易凭证信息guard let reciptInfo = self.getReciptInfo() else {if let transaction = transaction {CSLog.info(module: "apple pay", "未完成订单 但是没有凭证,直接销单")SKPaymentQueue.default().finishTransaction(transaction)}return}// 商品idguard let productId = reciptInfo["productId"] as? String else { return }// 订单idguard let preorderId = reciptInfo["preorderId"] as? String else { return }// 交易金额guard let amount = reciptInfo["amount"] as? String else { return }// 货币类型guard let currency = reciptInfo["currency"] as? String else { return }// 交易凭证var receipt = reciptInfo["receipt"] as? Stringif receipt == nil {CSLog.info(module: "apple pay", "未点击完成的漏单处理")receipt = self.getRecepitStr()}// 交易idvar transactionId = reciptInfo["transactionId"] as? Stringvar current_transaction:SKPaymentTransaction?if transaction == nil {let transactions = SKPaymentQueue.default().transactionsfor transaction in transactions {if let transactionId = transactionId {if transaction.transactionIdentifier == transactionId {current_transaction = transactionCSLog.info(module: "apple pay", "获取到付款完成的交易")break}} else {transactionId = transaction.transactionIdentifiercurrent_transaction = transactionCSLog.info(module: "apple pay", "获取到未付款完成的交易")}}} else {CSLog.info(module: "apple pay", "用户已经完成购买,直接验单")current_transaction = transactiontransactionId = transaction?.transactionIdentifier}guard let transaction = current_transaction else {CSLog.info(module: "apple pay", "transaction is nil")return }guard let receipt = receipt else {CSLog.info(module: "apple pay", "receipt is nil")return }guard let transactionId = transactionId else {CSLog.info(module: "apple pay", "transactionId is nil")return }/// 服务端校验收据verifyReceipt(productId: productId, preorderId: preorderId, amount: amount, currency: currency, receipt: receipt, transactionId: transactionId, transaction: transaction)}

漏单检测的代码看起来有一点复杂,简单一点说:

我们需要从已经保存的数据中获取服务端所需要的数据,比如订单id,商品id,交易id,金额,货币等等。
从SKPaymentQueue.default().transactions交易队列中获取没有消除的交易。

获取到这些数据之后调用服务端验单接口。

输入密码但苹果未响应

当用户输入密码完成之后,理论上会出现支付成功弹窗,点击弹窗的完成后进购买结果的回调方法中。

但是如果因为用户操作,或者网络原因导致没有出现支付成功弹窗。也会中断支付流程,导致充值金币不能到账。

为了处理这种情况,我们需要提前存储服务端验单所需要的信息。

我们将它放置在发起购买时,代码如下:

    //MARK: 发起购买请求func startPay(product:DGProductModel,preorderId:String,resultBlock:((_ success:Bool,_ error:Error?,_ result:String)->Void)?)  {self.resultBlock = resultBlockself.product = productself.preorderId = preorderIdif !SKPaymentQueue.canMakePayments() {CSLog.info(module: "pay", "pay failed2,productId=\(proId)")resultBlock?(false,nil,"不可使用苹果支付")return}.....// 存储一些交易信息guard let productId = product.productId else { return }guard let amount = product.showAmount else { return }guard let currency = product.currency else { return }self.saveReciptInfo(productId: productId,preorderId: preorderId, amount: amount,currency: currency)}

等到APP重新启动时,会直接触发购买监听的回调方法,进入购买完成状态,进入completePay方法,但此时没有product,以及订单等其他信息,所以我们之间转到validateReceipt方法进行验证,这时候上一步我们存储的信息就派上了用场:

    //MARK: 购买成功验证凭证func completePay(transaction:SKPaymentTransaction) {//获取交易凭证if let base64Str = self.getRecepitStr(transaction: transaction) {if let product = self.product {guard let productId = product.productId else { return }guard let amount = product.showAmount else { return }guard let currency = product.currency else { return }guard let preorderId = preorderId else { return }guard let transactionId = transaction.transactionIdentifier else { return }// 服务端校验verifyReceipt(productId: productId, preorderId: preorderId, amount: amount, currency: currency, receipt: base64Str, transactionId: transactionId, transaction: transaction)} else {validateReceipt(transaction: transaction)}}}

validateReceipt方法的实现和上面的实现是一样的,就不重复粘贴代码了。

结语

以上就是客户端处理漏单的两种情况,这些漏单的处理方案可以大大减少客户端支付出现的漏单问题。通过有效的监控和处理机制,不仅能够提升用户体验,还能提高支付的成功率,保障用户权益和业务的顺利进行。希望这些方法能为开发者在实际应用中提供有价值的参考,确保支付流程的稳定与可靠。

这篇关于三.苹果支付 - 漏单补单处理的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1069949

相关文章

Python实现批量CSV转Excel的高性能处理方案

《Python实现批量CSV转Excel的高性能处理方案》在日常办公中,我们经常需要将CSV格式的数据转换为Excel文件,本文将介绍一个基于Python的高性能解决方案,感兴趣的小伙伴可以跟随小编一... 目录一、场景需求二、技术方案三、核心代码四、批量处理方案五、性能优化六、使用示例完整代码七、小结一、

Python中 try / except / else / finally 异常处理方法详解

《Python中try/except/else/finally异常处理方法详解》:本文主要介绍Python中try/except/else/finally异常处理方法的相关资料,涵... 目录1. 基本结构2. 各部分的作用tryexceptelsefinally3. 执行流程总结4. 常见用法(1)多个e

PHP应用中处理限流和API节流的最佳实践

《PHP应用中处理限流和API节流的最佳实践》限流和API节流对于确保Web应用程序的可靠性、安全性和可扩展性至关重要,本文将详细介绍PHP应用中处理限流和API节流的最佳实践,下面就来和小编一起学习... 目录限流的重要性在 php 中实施限流的最佳实践使用集中式存储进行状态管理(如 Redis)采用滑动

MyBatis-plus处理存储json数据过程

《MyBatis-plus处理存储json数据过程》文章介绍MyBatis-Plus3.4.21处理对象与集合的差异:对象可用内置Handler配合autoResultMap,集合需自定义处理器继承F... 目录1、如果是对象2、如果需要转换的是List集合总结对象和集合分两种情况处理,目前我用的MP的版本

Python自动化处理PDF文档的操作完整指南

《Python自动化处理PDF文档的操作完整指南》在办公自动化中,PDF文档处理是一项常见需求,本文将介绍如何使用Python实现PDF文档的自动化处理,感兴趣的小伙伴可以跟随小编一起学习一下... 目录使用pymupdf读写PDF文件基本概念安装pymupdf提取文本内容提取图像添加水印使用pdfplum

C# LiteDB处理时间序列数据的高性能解决方案

《C#LiteDB处理时间序列数据的高性能解决方案》LiteDB作为.NET生态下的轻量级嵌入式NoSQL数据库,一直是时间序列处理的优选方案,本文将为大家大家简单介绍一下LiteDB处理时间序列数... 目录为什么选择LiteDB处理时间序列数据第一章:LiteDB时间序列数据模型设计1.1 核心设计原则

基于Redis自动过期的流处理暂停机制

《基于Redis自动过期的流处理暂停机制》基于Redis自动过期的流处理暂停机制是一种高效、可靠且易于实现的解决方案,防止延时过大的数据影响实时处理自动恢复处理,以避免积压的数据影响实时性,下面就来详... 目录核心思路代码实现1. 初始化Redis连接和键前缀2. 接收数据时检查暂停状态3. 检测到延时过

Java利用@SneakyThrows注解提升异常处理效率详解

《Java利用@SneakyThrows注解提升异常处理效率详解》这篇文章将深度剖析@SneakyThrows的原理,用法,适用场景以及隐藏的陷阱,看看它如何让Java异常处理效率飙升50%,感兴趣的... 目录前言一、检查型异常的“诅咒”:为什么Java开发者讨厌它1.1 检查型异常的痛点1.2 为什么说

Python利用PySpark和Kafka实现流处理引擎构建指南

《Python利用PySpark和Kafka实现流处理引擎构建指南》本文将深入解剖基于Python的实时处理黄金组合:Kafka(分布式消息队列)与PySpark(分布式计算引擎)的化学反应,并构建一... 目录引言:数据洪流时代的生存法则第一章 Kafka:数据世界的中央神经系统消息引擎核心设计哲学高吞吐

Go语言使用Gin处理路由参数和查询参数

《Go语言使用Gin处理路由参数和查询参数》在WebAPI开发中,处理路由参数(PathParameter)和查询参数(QueryParameter)是非常常见的需求,下面我们就来看看Go语言... 目录一、路由参数 vs 查询参数二、Gin 获取路由参数和查询参数三、示例代码四、运行与测试1. 测试编程路