重点总结:
1.获取内购列表(从App内读取或从自己服务器读取)
2.App Store请求可用的内购列表
3.向用户展示内购列表
4.用户选择了内购列表,再发个购买请求,收到购买完成的回调(购买完成后会把钱打给申请内购的银行卡内)
5.购买流程结束后, 向服务器发起验证凭证以及支付结果的请求
6.自己的服务器将支付结果信息返回给前端并发放虚拟产品
7.服务端的工作比较简单,分4步:
7.1.接收ios端发过来的购买凭证。
7.2.判断凭证是否已经存在或验证过,然后存储该凭证。
7.3.将该凭证发送到苹果的服务器验证,并将验证结果返回给客户端。
7.4.如果需要,修改用户相应的会员权限。
7.5.考虑到网络异常情况,服务器的验证应该是一个可恢复的队列,如果网络失败了,应该进行重试。
简单来说就是将该购买凭证用Base64编码,然后POST给苹果的验证服务器,苹果将验证结果以JSON形式返回。
一、使用注意事项及遇到的坑
####1.使用注意
- 代码中的_currentProId所填写的是你的购买项目的的ID,这个和第二步创建的内购的productID要一致,产品id与_currentProId一致。
- 在监听购买结果后,一定要调用[[SKPaymentQueue defaultQueue] finishTransaction:tran];来允许你从支付队列中移除交易。
- 真机测试的时候,一定要退出原来的账号(app store 登录的账号退出),才能用沙盒测试账号。
- 请务必使用真机来测试,一切以真机为准。
- 项目的Bundle identifier需要与您申请AppID时填写的bundleID一致,不然会无法请求到商品信息。
- 沙盒环境测试appStore内购流程的时候,请使用没越狱的设备。
- 二次验证,请注意区分宏, 测试用沙盒验证,App Store审核的时候也使用的是沙盒购买,所以验证购买凭证的时候需要判断返回Status Code决定是否去沙盒进行二次验证,为了线上用户的使用,验证的顺序肯定是先验证正式环境,此时若返回值为21007,就需要去沙盒二次验证,因为此购买的是在沙盒进行的。
8.货币类型(Bank Account Currency) :填CNY(如果你的app在中国使用的话)。
####2.获取不到商品信息
1.确定配置环节正确。
2.确定是真机测试且手机没有越狱。
3.确定内购商品添加到了需要内购功能的App中。
4.确定当前运行的App的Bundle ID和后台配置的App的Bundle ID是一致的。
5.可以尝试先删除旧App,再重新编译生成新的,避免新App未覆盖错误。
6.这里要提一点,沙盒的测试账号和你请求商品信息没有关系。请求商品信息的流程是,你在后台配置好了内购商品,并且将其添加到了需要集成内购功能的App中,然后你请求商品。请求到商品后的流程是这样的,苹果系统会自动弹出登录框让你登录账号。然后根据提示操作进行购买,这里的账号就是你配置的沙盒测试账号。
二、为什么要使用内购?(why)和内购是什么?(what)
1.如果你购买的商品,是在本app中使用和消耗的,就一定要用内购,否则会被拒绝上线,例如:游戏币,在线书籍
app中使用的道具等。本例中,就是直播中你用来打赏用的金币,那东西可就属于消耗型的。
2.如果是直接购买商城之类的快递包邮的那些东东,那就直接调用支付宝,微信啦,之类的三方支付就好了,淘宝,京东都玩过哈!
比较坑的一点就是,内购的话,还要和苹果3/7分成,那就可以说,充值相同的钱,相对来说,iOS是比安卓亏的!
三、怎样使用内购?(how)
(1)使用内购需要哪些资料
1张visa银行卡,appid,1张银行卡与苹果三七分打钱用
协议、税务和银行业务
联系人信息:(appid账号人)姓名,邮箱,电话号码,地址(城市、具体街道分行写)
visa银行卡信息:开户行,开户行所在地址,开户行的邮政编码,开户行持有人卡号,开户行持有人姓名
税务信息:1.会问你是不是美国居民选择NO. 2. 有没有在美国从事商业性活动,选择NO. 之后填写个人或组织名称,所在国家,受益方式(独立开发者选择个人),居住地址,邮寄地址,声明人,头衔
(2) 内购产品id的配置 (开发人员配置)
如果是金币或其它消耗品的产品的话用消耗性型项目,参考名称(内购项目,比如金币100),产品id,定价信息,使用内购的快照,显示名称,描述。
(3) 用户职能
测试员:添加水箱测试员及沙箱账号,水箱测试账号不能是正常使用的appid账号,直接使用一个没有注册过的邮箱账号即可。
姓名,测试账号密码,appstore地区(必须填对)。
代码如下 :
/*注意事项:
1.沙盒环境测试appStore内购流程的时候,请使用没越狱的设备。
2.请务必使用真机来测试,一切以真机为准。
3.项目的Bundle identifier需要与您申请AppID时填写的bundleID一致,不然会无法请求到商品信息。
4.如果是你自己的设备上已经绑定了自己的AppleID账号请先注销掉,否则你哭爹喊娘都不知道是怎么回事。
5.订单校验 苹果审核app时,仍然在沙盒环境下测试,所以需要先进行正式环境验证,如果发现是沙盒环境则转到沙盒验证。
识别沙盒环境订单方法:
1.根据字段 environment = sandbox。
2.根据验证接口返回的状态码,如果status=21007,则表示当前为沙盒环境。
苹果反馈的状态码:
21000App Store无法读取你提供的JSON数据
21002 订单数据不符合格式
21003 订单无法被验证
21004 你提供的共享密钥和账户的共享密钥不一致
21005 订单服务器当前不可用
21006 订单是有效的,但订阅服务已经过期。当收到这个信息时,解码后的收据信息也包含在返回内容中
21007 订单信息是测试用(sandbox),但却被发送到产品环境中验证
21008 订单信息是产品环境中使用,但却被发送到测试环境中验证
*/
#import <Foundation/Foundation.h>
typedef enum {
SIAPPurchSuccess = 0, // 购买成功
SIAPPurchFailed = 1, // 购买失败
SIAPPurchCancle = 2, // 取消购买
SIAPPurchVerFailed = 3, // 订单校验失败
SIAPPurchVerSuccess = 4, // 订单校验成功
SIAPPurchNotArrow = 5, // 不允许内购
}SIAPPurchType;
typedef void (^IAPCompletionHandle)(SIAPPurchType type,NSData *data);
@interface STRIAPManager : NSObject
+ (instancetype)shareSIAPManager;
//开始内购
- (void)startPurchWithID:(NSString *)purchID completeHandle:(IAPCompletionHandle)handle;
@end
.m
#import "STRIAPManager.h"
#import <StoreKit/StoreKit.h>
@interface STRIAPManager()<SKPaymentTransactionObserver,SKProductsRequestDelegate>{
NSString *_purchID;
IAPCompletionHandle _handle;
}
@end
@implementation STRIAPManager
#pragma mark - ♻️life cycle
+ (instancetype)shareSIAPManager{
static STRIAPManager *IAPManager = nil;
static dispatch_once_t onceToken;
dispatch_once(&onceToken,^{
IAPManager = [[STRIAPManager alloc] init];
});
return IAPManager;
}
- (instancetype)init{
self = [super init];
if (self) {
// 购买监听写在程序入口,程序挂起时移除监听,这样如果有未完成的订单将会自动执行并回调 paymentQueue:updatedTransactions:方法
[[SKPaymentQueue defaultQueue] addTransactionObserver:self];
}
return self;
}
- (void)dealloc{
[[SKPaymentQueue defaultQueue] removeTransactionObserver:self];
}
#pragma mark - 🚪public
- (void)startPurchWithID:(NSString *)purchID completeHandle:(IAPCompletionHandle)handle{
if (purchID) {
if ([SKPaymentQueue canMakePayments]) {
// 开始购买服务
_purchID = purchID;
_handle = handle;
NSSet *nsset = [NSSet setWithArray:@[purchID]];
SKProductsRequest *request = [[SKProductsRequest alloc] initWithProductIdentifiers:nsset];
request.delegate = self;
[request start];
}else{
[self handleActionWithType:SIAPPurchNotArrow data:nil];
}
}
}
#pragma mark - 🔒private
- (void)handleActionWithType:(SIAPPurchType)type data:(NSData *)data{
#if DEBUG
switch (type) {
case SIAPPurchSuccess:
NSLog(@"购买成功");
break;
case SIAPPurchFailed:
NSLog(@"购买失败");
break;
case SIAPPurchCancle:
NSLog(@"用户取消购买");
break;
case SIAPPurchVerFailed:
NSLog(@"订单校验失败");
break;
case SIAPPurchVerSuccess:
NSLog(@"订单校验成功");
break;
case SIAPPurchNotArrow:
NSLog(@"不允许程序内付费");
break;
default:
break;
}
#endif
if(_handle){
_handle(type,data);
}
}
#pragma mark - 🍐delegate
// 交易结束
- (void)completeTransaction:(SKPaymentTransaction *)transaction{
// Your application should implement these two methods.
NSString * productIdentifier = transaction.payment.productIdentifier;
NSString * receipt = [transaction.transactionReceipt base64EncodedString];
if ([productIdentifier length] > 0) {
// 向自己的服务器验证购买凭证
}
[self verifyPurchaseWithPaymentTransaction:transaction isTestServer:NO];
}
// 交易失败
- (void)failedTransaction:(SKPaymentTransaction *)transaction{
if (transaction.error.code != SKErrorPaymentCancelled) {
[self handleActionWithType:SIAPPurchFailed data:nil];
}else{
[self handleActionWithType:SIAPPurchCancle data:nil];
}
[[SKPaymentQueue defaultQueue] finishTransaction:transaction];
}
- (void)verifyPurchaseWithPaymentTransaction:(SKPaymentTransaction *)transaction isTestServer:(BOOL)flag{
//交易验证
NSURL *recepitURL = [[NSBundle mainBundle] appStoreReceiptURL];
NSData *receipt = [NSData dataWithContentsOfURL:recepitURL];
if(!receipt){
// 交易凭证为空验证失败
[self handleActionWithType:SIAPPurchVerFailed data:nil];
return;
}
// 购买成功将交易凭证发送给服务端进行再次校验
[self handleActionWithType:SIAPPurchSuccess data:receipt];
NSError *error;
NSDictionary *requestContents = @{
@"receipt-data": [receipt base64EncodedStringWithOptions:0]
};
NSData *requestData = [NSJSONSerialization dataWithJSONObject:requestContents
options:0
error:&error];
if (!requestData) { // 交易凭证为空验证失败
[self handleActionWithType:SIAPPurchVerFailed data:nil];
return;
}
//In the test environment, use https://sandbox.itunes.apple.com/verifyReceipt
//In the real environment, use https://buy.itunes.apple.com/verifyReceipt
NSString *serverString = @"https://buy.itunes.apple.com/verifyReceipt";
if (flag) {
serverString = @"https://sandbox.itunes.apple.com/verifyReceipt";
}
NSURL *storeURL = [NSURL URLWithString:serverString];
NSMutableURLRequest *storeRequest = [NSMutableURLRequest requestWithURL:storeURL];
[storeRequest setHTTPMethod:@"POST"];
[storeRequest setHTTPBody:requestData];
NSOperationQueue *queue = [[NSOperationQueue alloc] init];
[NSURLConnection sendAsynchronousRequest:storeRequest queue:queue
completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
if (connectionError) {
// 无法连接服务器,购买校验失败
[self handleActionWithType:SIAPPurchVerFailed data:nil];
} else {
NSError *error;
NSDictionary *jsonResponse = [NSJSONSerialization JSONObjectWithData:data options:0 error:&error];
if (!jsonResponse) {
// 苹果服务器校验数据返回为空校验失败
[self handleActionWithType:SIAPPurchVerFailed data:nil];
}
// 先验证正式服务器,如果正式服务器返回21007再去苹果测试服务器验证,沙盒测试环境苹果用的是测试服务器
NSString *status = [NSString stringWithFormat:@"%@",jsonResponse[@"status"]];
if (status && [status isEqualToString:@"21007"]) {
[self verifyPurchaseWithPaymentTransaction:transaction isTestServer:YES];
}else if(status && [status isEqualToString:@"0"]){
[self handleActionWithType:SIAPPurchVerSuccess data:nil];
}
#if DEBUG
NSLog(@"----验证结果 %@",jsonResponse);
#endif
}
}];
// 验证成功与否都注销交易,否则会出现虚假凭证信息一直验证不通过,每次进程序都得输入苹果账号
[[SKPaymentQueue defaultQueue] finishTransaction:transaction];
}
#pragma mark - SKProductsRequestDelegate
- (void)productsRequest:(SKProductsRequest *)request didReceiveResponse:(SKProductsResponse *)response{
NSArray *product = response.products;
if([product count] <= 0){
#if DEBUG
NSLog(@"--------------没有商品------------------");
#endif
return;
}
SKProduct *p = nil;
for(SKProduct *pro in product){
if([pro.productIdentifier isEqualToString:_purchID]){
p = pro;
break;
}
}
#if DEBUG
NSLog(@"productID:%@", response.invalidProductIdentifiers);
NSLog(@"产品付费数量:%lu",(unsigned long)[product count]);
NSLog(@"%@",[p description]);
NSLog(@"%@",[p localizedTitle]);
NSLog(@"%@",[p localizedDescription]);
NSLog(@"%@",[p price]);
NSLog(@"%@",[p productIdentifier]);
NSLog(@"发送购买请求");
#endif
SKPayment *payment = [SKPayment paymentWithProduct:p];
[[SKPaymentQueue defaultQueue] addPayment:payment];
}
//请求失败
- (void)request:(SKRequest *)request didFailWithError:(NSError *)error{
#if DEBUG
NSLog(@"------------------错误-----------------:%@", error);
#endif
}
- (void)requestDidFinish:(SKRequest *)request{
#if DEBUG
NSLog(@"------------反馈信息结束-----------------");
#endif
}
#pragma mark - SKPaymentTransactionObserver
- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray<SKPaymentTransaction *> *)transactions{
for (SKPaymentTransaction *tran in transactions) {
switch (tran.transactionState) {
case SKPaymentTransactionStatePurchased:
[self completeTransaction:tran];
break;
case SKPaymentTransactionStatePurchasing:
#if DEBUG
NSLog(@"商品添加进列表");
#endif
break;
case SKPaymentTransactionStateRestored:
#if DEBUG
NSLog(@"已经购买过商品");
#endif
// 消耗型不支持恢复购买
[[SKPaymentQueue defaultQueue] finishTransaction:tran];
break;
case SKPaymentTransactionStateFailed:
[self failedTransaction:tran];
break;
default:
break;
}
}
}
@end
在控制器中调用,导入头文件
调用方法
- (void)purchaseAction{
if (!_IAPManager) {
_IAPManager = [STRIAPManager shareSIAPManager];
}
// iTunesConnect 苹果后台配置的产品ID
[_IAPManager startPurchWithID:@"com.bb.helper_advisory" completeHandle:^(SIAPPurchType type,NSData *data) {
//请求事务回调类型,返回的数据
}];
}
经典文章参考:
- [内购流程] [ng]
[ng]: http://yimouleng.com/2015/12/17/ios-AppStore/ 内购流程 - http://www.jianshu.com/p/b199a4672608 完成交易后和服务器交互
- http://www.jianshu.com/p/1ef61a785508 沙盒账号测试