此文章用于记录处理苹果内购客户端 消耗品 相关卡点
不包括App Store connect 配置
内购管理单利类,实现全局监听,集中处理系统回调。
+ (instancetype)sharedManager
{
static dispatch_once_t onceToken;
static IAPManager *iAPManager;
dispatch_once(&onceToken, ^{
iAPManager = [[IAPManager alloc] init];
[[SKPaymentQueue defaultQueue] addTransactionObserver:iAPManager];
});
return iAPManager;
}
虽然addTransactionObserver 是不会被强引用的,建议在app启动时即进入监听状态,确保不丢失系统内置交易模块回调信息
// Observers are not retained. The transactions array will only be synchronized with the server while the queue has observers. This may require that the user authenticate.
- (void)addTransactionObserver:(id <SKPaymentTransactionObserver>)observer NS_AVAILABLE(10_7, 3_0);
添加restoreCompletedTransactions 是为了在用户在支付流程产生错误,再次交易的时候可以收到回调。主要是在回调中关闭交易,避免系统出现重复购买的提示。
此功能使用场景:App内存在“回复购买”,点击后调用此方法,然后在回调中进行逻辑处理
// Asynchronous. Will add completed transactions for the current user back to the queue to be re-completed. User will be asked to authenticate. Observers will receive 0 or more -paymentQueue:updatedTransactions:, followed by either -paymentQueueRestoreCompletedTransactionsFinished: on success or -paymentQueue:restoreCompletedTransactionsFailedWithError: on failure. In the case of partial success, some transactions may still be delivered.
- (void)restoreCompletedTransactions NS_AVAILABLE(10_7, 3_0);
回调函数
// Sent when an error is encountered while adding transactions from the user's purchase history back to the queue.
- (void)paymentQueue:(SKPaymentQueue *)queue restoreCompletedTransactionsFailedWithError:(NSError *)error NS_AVAILABLE(10_7, 3_0);
// Sent when all transactions from the user's purchase history have successfully been added back to the queue.
- (void)paymentQueueRestoreCompletedTransactionsFinished:(SKPaymentQueue *)queue NS_AVAILABLE(10_7, 3_0);
苹果的消耗品是不绑定用户ID关系的,用户A使用App ID (account A) 产生了支付后,用户B 同样使用(account A) 进行支付是不会成功的。同一个App ID 对于消耗品不区分用户的,即但凡存在一个未消耗的商品,不能进行下一次购买。如果不在回调函数中将交易关闭,那么系统会提示
交易开始前需要先将本地未关闭的交易关闭掉,也可以在这里进行逻辑处理,完成未完成的交易。
transaction.transactionIdentifier 同一个订单是唯一固定不变的,即使app产生了崩溃,再次启动app 调用了addTransactionObserver,系统依然会在回调中给出这个商品的信息。
回调函数
- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray *)transactions
{
transaction.transactionState 枚举定义
/*
SKPaymentTransactionStatePurchasing, 正在购买
SKPaymentTransactionStatePurchased, 购买完成(销毁交易)
SKPaymentTransactionStateFailed, 购买失败(销毁交易)
SKPaymentTransactionStateRestored, 恢复购买(销毁交易)
SKPaymentTransactionStateDeferred 最终状态未确定
*/
}
所有交易的状态都会在这里进行交互,其中特别注意 三种状态需要摧毁交易
[[SKPaymentQueue defaultQueue] finishTransaction:transaction];
苹果支付成功后会在本地存储一个交易凭证,将交易凭证投递服务器验证,服务器接收到购买凭证后去苹果服务器验证,等待结果返回加钻石或者其他操作,然后返回结果。
此凭证需要在本地进行一个缓存,待服务器验证回调结果后进行移除,一定程度避免丢单。
此凭证只会在交易存在时获取到,当调用摧毁交易(上述方法)后,本地是无法获取到的.经测试,摧毁交易的方法为异步处理,所以为了谨慎,一定要在获取完凭证之后调用摧毁交易的方法.
+ (NSString *)IAPReceipt
{
NSString *receiptString = @"";
//目前苹果公司提倡的获取购买凭证的方法
NSURL *rereceiptURL = [[NSBundle mainBundle] appStoreReceiptURL];
if ([[NSFileManager defaultManager] fileExistsAtPath:[rereceiptURL path]]) {
NSData *receiptData = [NSData dataWithContentsOfURL:rereceiptURL];
//base64位的产品验证码单,base64是服务端和苹果进行校验所必须的,苹果的文档要求凭证经过Base64加密
receiptString = [receiptData base64EncodedStringWithOptions:0];
}
return receiptString;
}