一.总说内购的内容
1.协议、税务和银行业务 信息填写
2.内购商品的添加
3.添加沙盒测试账号
4.内购代码的具体实现
5.内购的注意事项
二.协议、税务和银行业务 信息填写
2.1、协议、税务和银行业务 信息填写 的入口
2.2、选择申请合同类型
进入协议、税务和银行业务页面后,会有3种合同类型,如果你之前没有主动申请过去合同,那么一般你现在激活的合同只有iOS Free Application一种。
-
页面内容分为两块:
Request Contracts(申请合同)
Contracts In Effect(已生效合同)。
-
合同类型分为3种:
iOS Free Application(免费应用合同)
iOS Paid Application(付费应用合同)
iAd App NetNetwork(广告合同)
这里我们主要主要讲一下付费应用合同的申请流程。
2.3、申请iOS Paid Application合同(协议、税务和银行业务3个都要填写)
2.4、Contact Info(填写联系方式)
如果你没有添加过联系人,你需要通过Add New Contact按钮来添加一个新的联系人。然后指定联系人的职务,
职务如下:
Senior Management:高管
Financial:财务
Technical:技术支持
Legal:法务
Marketing:市场推广
如果你是独立开发者,可以全部填你自己一个人。
2.5、填写银行信息
选择你的银行账户,如果你没有,点击旁边的Add Bank Account添加一个账户。下面是添加一个账户的流程。
2.5.1、选择银行所在的国家
2.5.2、填写银行标识CNAPS Code
如果你不知道CNAPS Code是多少,可以百度搜CNAPS Code来查询,查询时会根据3个关键信息来查询,如下:
Bank Name:银行的英文名称(不能是拼音)
City:银行所在的城市英文名称(中国的城市用拼音)
Postal Code:邮编
然后在下面就会出来备选的银行,选择正确的银行后,点击next,进入下一步。
2.5.3、确认银行信息
2.5.4、填写银行账号信息
Bank Account Number:银行账号
Confirm Bank Account Number:再次输入银行账号
Account Holder Name:持卡人姓名,中文名用拼写,名在前,姓在后
Bank Account Currency:货币类型,一般国内的开发者选择CNY
2.5.5、确认所有信息
2.6.填写税务信息(这个内容比较多)
-
2.6.1.税务信息这一块了解不是很多,不过因为是国内开发者,可以不用太费心,税务信息分3种:
U.S Tax Forms:美国税务
Australia Tax Forms:澳大利亚税务
Canada Tax Forms:加拿大税务
2.6.2.一堆条约
我选择的是U.S Tax Forms,选择后会问你两个问题:
第1个问题如下:询问你是否是美国居民,有没有美国伙伴关系或者美国公司,如果没有直接选择No。
接下来第二个问题如下:询问你有没有在美国的商业性活动,没有也直接选No
2.6.3.然后填写你的税务信息,包括以下几点:
Individual or Organization Name:个人或者组织名称
Country of incorporation: 所在国家
Type of Beneficial Owner:受益方式,独立开发者选个人
Permanent Residence:居住地址
Mailing address:邮寄地址
Name of Person Making this Declaration:声明人
Title:头衔
2.6.4.打钩
2.6.5.澳大利亚的不要管了
2.6.6.加拿大的也不用管了
2.7.填写完成
2.8.待审核
你填写完所有资料后,合同状态就会变成Processing, 大概24小时内就会有结果。
三.内购商品的添加
3.1.创建内购商品
3.2.选择内购类型
-
3.2.1.消耗型商品:类似游戏中的钻石,还有现在某些APP中的货币,比如斗鱼里的鱼丸、映客里的映票。会被消耗的,要选择消耗型商品
注意:大多数的消耗型商品都是需要登录的,因为需要在数据库存余额。
需要注意的是:在登录之前,你最好不要让用户看到商品,有可能会因为这个原因被拒(大家都说看运气)
-
3.2.2.非消耗型商品:无法被消耗的商品,比如上文提到的视频课程,一次购买,就应该永久可以观看
注意:当你使用非消耗型商品时,你需要添加一个恢复购买的按钮
这个常见于各种游戏中,其实知道这个规定以后还是挺好理解的,非消耗型商品是不可被消耗的,一次购买终身使用的,非消耗型的商品是跟appleId绑定的,就是你平时下载APP让你输入账号密码的内个。
你需要一个恢复购买的按钮,来让用户恢复他购买的内容
-
3.2.3.订阅类型商品:如果你的公司是外包公司,有订阅类型商品的APP一定要用客户的账号提交审核,因为当APP中有过订阅类型商品,注意是有过,创建过再删除也算,这个APP无法被转移账号
注意:使用或曾经使用过订阅型商品的APP无法转移
3.3.创建好的产品
3.4.在上线的时候记得添加内购的商品
四.添加沙盒测试账号
4.1.添加沙盒测试的入口
4.2.添加沙盒测试账号
4.3.具体的测试账号信息填写
五.内购代码的具体实现(这才是大家所期望看到的)
-
5.1.我创建了一个购买金币的内购控制器ApplePayCIOViewController
在此,我仅仅向大家贴出.m的详细代码
5.2.内购的流程详细讲解
5.2.1. 用户先拿到购买产品的单子,
5.2.2.拿着单子去苹果那里交钱,交完钱让苹果在单子上盖个章
5.2.3.拿着盖了章的单子传给自己的服务器来验证是否真的支付成功
5.2.4.根据服务器返回的信息做具体的处理
5.3.上代码
5.3.1..先导入StoreKit.framework库;
5.3.2.创建ApplePayCIOViewController,遵守协议<SKPaymentTransactionObserver,SKProductsRequestDelegate>
5.3.3.ApplePayCIOViewController.m代码
#import "ApplePayCIOViewController.h"
#import <StoreKit/StoreKit.h>
// 产品的ID
#define ProductID1 @"CIOCourses1"
@interface ApplePayCIOViewController ()<SKProductsRequestDelegate,SKPaymentTransactionObserver>
{
NSString *selectProductID;
}
@end
@implementation ApplePayCIOViewController
-(void)viewWillAppear:(BOOL)animated{
[super viewWillAppear:animated];
// 添加观察者
[[SKPaymentQueue defaultQueue] addTransactionObserver:self];
}
-(void)viewWillDisappear:(BOOL)animated{
[super viewWillDisappear:animated];
// 移除观察者
[[SKPaymentQueue defaultQueue] removeTransactionObserver:self];
} - (void)viewDidLoad {
[super viewDidLoad];
self.title = @"内购"; self.navigationItem.rightBarButtonItem = [[UIBarButtonItem alloc]initWithTitle:@"测试" style:UIBarButtonItemStylePlain target:self action:@selector(test)]; // 恢复购买的按钮
UIButton * revert = [[UIButton alloc]initWithFrame:CGRectMake(, , , )];
[revert setBackgroundColor:JKRandomColor];
[revert addTarget:self action:@selector(replyToBuy) forControlEvents:UIControlEventTouchUpInside];
[self.view addSubview: revert];
self.view.backgroundColor =[UIColor redColor];
} #pragma mark 恢复购买(主要是针对非消耗产品)
-(void)replyToBuy{ [[SKPaymentQueue defaultQueue] restoreCompletedTransactions];
}
#pragma mark 测试内购
-(void)test{ if([SKPaymentQueue canMakePayments]){ // productID就是你在创建购买项目时所填写的产品ID
selectProductID = [NSString stringWithFormat:@"%@",ProductID1];
[self requestProductID:selectProductID]; }else{ // NSLog(@"不允许程序内付费");
UIAlertView *alertError = [[UIAlertView alloc] initWithTitle:@"温馨提示"
message:@"请先开启应用内付费购买功能。"
delegate:nil
cancelButtonTitle:@"确定"
otherButtonTitles: nil];
[alertError show];
}
}
#pragma mark 1.请求所有的商品ID
-(void)requestProductID:(NSString *)productID{ // 1.拿到所有可卖商品的ID数组
NSArray *productIDArray = [[NSArray alloc]initWithObjects:productID, nil];
NSSet *sets = [[NSSet alloc]initWithArray:productIDArray]; // 2.向苹果发送请求,请求所有可买的商品
// 2.1.创建请求对象
SKProductsRequest *sKProductsRequest = [[SKProductsRequest alloc]initWithProductIdentifiers:sets];
// 2.2.设置代理(在代理方法里面获取所有的可卖的商品)
sKProductsRequest.delegate = self;
// 2.3.开始请求
[sKProductsRequest start]; }
#pragma mark 2.苹果那边的内购监听
-(void)productsRequest:(SKProductsRequest *)request didReceiveResponse:(SKProductsResponse *)response{ NSLog(@"可卖商品的数量=%ld",response.products.count); NSArray *product = response.products;
if([product count] == ){ NSLog(@"没有商品");
return;
} for (SKProduct *sKProduct in product) { NSLog(@"pro info");
NSLog(@"SKProduct 描述信息:%@", sKProduct.description);
NSLog(@"localizedTitle 产品标题:%@", sKProduct.localizedTitle);
NSLog(@"localizedDescription 产品描述信息:%@",sKProduct.localizedDescription);
NSLog(@"price 价格:%@",sKProduct.price);
NSLog(@"productIdentifier Product id:%@",sKProduct.productIdentifier); if([sKProduct.productIdentifier isEqualToString: selectProductID]){ [self buyProduct:sKProduct]; break; }else{ //NSLog(@"不不不相同");
}
} } #pragma mark 内购的代码调用
-(void)buyProduct:(SKProduct *)product{ // 1.创建票据
SKPayment *skpayment = [SKPayment paymentWithProduct:product]; // 2.将票据加入到交易队列
[[SKPaymentQueue defaultQueue] addPayment:skpayment]; // 3.添加观察者,监听用户是否付钱成功(不在此处添加观察者)
//[[SKPaymentQueue defaultQueue] addTransactionObserver:self]; } #pragma mark 4.实现观察者监听付钱的代理方法,只要交易发生变化就会走下面的方法
-(void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray<SKPaymentTransaction *> *)transactions{ /*
SKPaymentTransactionStatePurchasing, 正在购买
SKPaymentTransactionStatePurchased, 已经购买
SKPaymentTransactionStateFailed, 购买失败
SKPaymentTransactionStateRestored, 回复购买中
SKPaymentTransactionStateDeferred 交易还在队列里面,但最终状态还没有决定
*/ for (SKPaymentTransaction *transaction in transactions) {
switch (transaction.transactionState) {
case SKPaymentTransactionStatePurchasing:{ NSLog(@"正在购买");
}break;
case SKPaymentTransactionStatePurchased:{ NSLog(@"购买成功");
// 购买后告诉交易队列,把这个成功的交易移除掉
[queue finishTransaction:transaction];
[self buyAppleStoreProductSucceedWithPaymentTransactionp:transaction];
}break;
case SKPaymentTransactionStateFailed:{ NSLog(@"购买失败");
// 购买失败也要把这个交易移除掉
[queue finishTransaction:transaction];
}break;
case SKPaymentTransactionStateRestored:{
NSLog(@"回复购买中,也叫做已经购买");
// 回复购买中也要把这个交易移除掉
[queue finishTransaction:transaction];
}break;
case SKPaymentTransactionStateDeferred:{ NSLog(@"交易还在队列里面,但最终状态还没有决定");
}break;
default:
break;
}
}
} // 苹果内购支付成功
- (void)buyAppleStoreProductSucceedWithPaymentTransactionp:(SKPaymentTransaction *)paymentTransactionp { NSString * productIdentifier = paymentTransactionp.payment.productIdentifier;
// NSLog(@"productIdentifier Product id:%@", productIdentifier);
NSString *transactionReceiptString= nil; //系统IOS7.0以上获取支付验证凭证的方式应该改变,切验证返回的数据结构也不一样了。
NSString *version = [UIDevice currentDevice].systemVersion;
if([version intValue] >= 7.0){
// 验证凭据,获取到苹果返回的交易凭据
// appStoreReceiptURL iOS7.0增加的,购买交易完成后,会将凭据存放在该地址
NSURLRequest * appstoreRequest = [NSURLRequest requestWithURL:[[NSBundle mainBundle]appStoreReceiptURL]];
NSError *error = nil;
NSData * receiptData = [NSURLConnection sendSynchronousRequest:appstoreRequest returningResponse:nil error:&error];
transactionReceiptString = [receiptData base64EncodedStringWithOptions:NSDataBase64EncodingEndLineWithLineFeed];
}else{ NSData * receiptData = paymentTransactionp.transactionReceipt;
// transactionReceiptString = [receiptData base64EncodedString];
transactionReceiptString = [receiptData base64EncodedStringWithOptions:NSDataBase64EncodingEndLineWithLineFeed];
}
// 去验证是否真正的支付成功了
[self checkAppStorePayResultWithBase64String:transactionReceiptString]; } - (void)checkAppStorePayResultWithBase64String:(NSString *)base64String { /* 生成订单参数,注意沙盒测试账号与线上正式苹果账号的验证途径不一样,要给后台标明 */
/*
注意:
自己测试的时候使用的是沙盒购买(测试环境)
App Store审核的时候也使用的是沙盒购买(测试环境)
上线以后就不是用的沙盒购买了(正式环境)
所以此时应该先验证正式环境,在验证测试环境 正式环境验证成功,说明是线上用户在使用
正式环境验证不成功返回21007,说明是自己测试或者审核人员在测试
*/
/*
苹果AppStore线上的购买凭证地址是: https://buy.itunes.apple.com/verifyReceipt
测试地址是:https://sandbox.itunes.apple.com/verifyReceipt
*/
// NSNumber *sandbox;
NSString *sandbox;
#if (defined(APPSTORE_ASK_TO_BUY_IN_SANDBOX) && defined(DEBUG))
//sandbox = @(0);
sandbox = @"";
#else
//sandbox = @(1);
sandbox = @"";
#endif NSMutableDictionary *prgam = [[NSMutableDictionary alloc] init];;
[prgam setValue:sandbox forKey:@"sandbox"];
[prgam setValue:base64String forKey:@"reciept"]; /*
请求后台接口,服务器处验证是否支付成功,依据返回结果做相应逻辑处理
0 代表沙盒 1代表 正式的内购
最后最验证后的
*/
/*
内购验证凭据返回结果状态码说明
21000 App Store无法读取你提供的JSON数据
21002 收据数据不符合格式
21003 收据无法被验证
21004 你提供的共享密钥和账户的共享密钥不一致
21005 收据服务器当前不可用
21006 收据是有效的,但订阅服务已经过期。当收到这个信息时,解码后的收据信息也包含在返回内容中
21007 收据信息是测试用(sandbox),但却被发送到产品环境中验证
21008 收据信息是产品环境中使用,但却被发送到测试环境中验证
*/ NSLog(@"字典==%@",prgam); } #pragma mark 客户端验证购买凭据
- (void)verifyTransactionResult
{
// 验证凭据,获取到苹果返回的交易凭据
// appStoreReceiptURL iOS7.0增加的,购买交易完成后,会将凭据存放在该地址
NSURL *receiptURL = [[NSBundle mainBundle] appStoreReceiptURL];
// 从沙盒中获取到购买凭据
NSData *receipt = [NSData dataWithContentsOfURL:receiptURL];
// 传输的是BASE64编码的字符串
/**
BASE64 常用的编码方案,通常用于数据传输,以及加密算法的基础算法,传输过程中能够保证数据传输的稳定性
BASE64是可以编码和解码的
*/
NSDictionary *requestContents = @{
@"receipt-data": [receipt base64EncodedStringWithOptions:]
};
NSError *error;
// 转换为 JSON 格式
NSData *requestData = [NSJSONSerialization dataWithJSONObject:requestContents
options:
error:&error];
// 不存在
if (!requestData) { /* ... Handle error ... */ } // 发送网络POST请求,对购买凭据进行验证
NSString *verifyUrlString;
#if (defined(APPSTORE_ASK_TO_BUY_IN_SANDBOX) && defined(DEBUG))
verifyUrlString = @"https://sandbox.itunes.apple.com/verifyReceipt";
#else
verifyUrlString = @"https://buy.itunes.apple.com/verifyReceipt";
#endif
// 国内访问苹果服务器比较慢,timeoutInterval 需要长一点
NSMutableURLRequest *storeRequest = [NSMutableURLRequest requestWithURL:[[NSURL alloc] initWithString:verifyUrlString] cachePolicy:NSURLRequestUseProtocolCachePolicy timeoutInterval:10.0f]; [storeRequest setHTTPMethod:@"POST"];
[storeRequest setHTTPBody:requestData]; // 在后台对列中提交验证请求,并获得官方的验证JSON结果
NSOperationQueue *queue = [[NSOperationQueue alloc] init];
[NSURLConnection sendAsynchronousRequest:storeRequest queue:queue
completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
if (connectionError) {
NSLog(@"链接失败");
} else {
NSError *error;
NSDictionary *jsonResponse = [NSJSONSerialization JSONObjectWithData:data options: error:&error];
if (!jsonResponse) {
NSLog(@"验证失败");
} // 比对 jsonResponse 中以下信息基本上可以保证数据安全
/*
bundle_id
application_version
product_id
transaction_id
*/ NSLog(@"验证成功");
}
}]; }
@end
六.内购的注意事项
6.1.一般发生于首次提交app或添加新商品,当你的app通过审核以后,你发现在生产环境下获取不到商品,这是因为app虽然过审核了,但是内购商品还没有正式添加到苹果的服务器里,耐心等待一段时间就可以啦~
6.2. 代码中的_currentProId所填写的是你的购买项目的的ID,这个和第二步创建的内购的productID要一致;本例中是 123。
6.3. 在监听购买结果后,一定要调用[[SKPaymentQueue defaultQueue] finishTransaction:tran];来允许你从支付队列中移除交易。
6.4. 沙盒环境测试appStore内购流程的时候,请使用没越狱的设备。
6.5. 请务必使用真机来测试,一切以真机为准。
6.6. 项目的Bundle identifier需要与您申请AppID时填写的bundleID一致,不然会无法请求到商品信息。
6.7. 真机测试的时候,一定要退出原来的账号,才能用沙盒测试账号
6.8. 二次验证,请注意区分宏, 测试用沙盒验证,App Store审核的时候也使用的是沙盒购买,所以验证购买凭证的时候需要判断返回Status Code决定是否去沙盒进行二次验证,为了线上用户的使用,验证的顺序肯定是先验证正式环境,此时若返回值为21007,就需要去沙盒二次验证,因为此购买的是在沙盒进行的。
6.9.您的应用是否处于等待开发者发布(Pending Developer Release)状态?等待发布状态的IAP是无法测试的。
6.10.您的内购项目是否是最近才新建的,或者进行了更改?内购项目需要一段时间才能反应到所有服务器上,这个过程一般是一两小时,也可能再长一些达到若干小时。
6.11.您在iTC中Contracts, Tax, and Banking Information项目中是否有还没有设置或者过期了的项目?不完整的财务信息无法进行内购测试。
6.12.您是在越狱设备上进行内购测试么?越狱设备不能用于正常内购,您需要重装或者寻找一台没有越狱的设备。
6.13.您的应用是否是被拒状态(Rejected)或自己拒绝(Developer Rejected)了?被拒绝状态的应用的话对应还未通过的内购项目也会一起被拒,因此您需要重新将IAP项目设为Cleared for Sale。
6.14.您使用的测试账号是否是美国区账号?虽然不是一定需要,但是鉴于其他地区的测试账号经常抽风,加上美国区账号一直很稳定,因此强烈建议使用美国区账号。正常情况下IAP不需要进行信用卡绑定和其他信息填写,如果你遇到了这种情况,可以试试删除这个测试账号再新建一个其他地区的。
6.15.您是否将设备上原来的app删除了,并重新进行了安装?记得在安装前做一下Clean和Clean Build Folder。
6.16.您的plist中的Bundle identifier的内容是否和您的AppID一致?