1内购所需要的资料整理总结

思维导图

image

重点总结：

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.使用注意
1\. 代码中的_currentProId所填写的是你的购买项目的的ID，这个和第二步创建的内购的productID要一致，产品id与_currentProId一致。

2\. 在监听购买结果后，一定要调用[[SKPaymentQueue defaultQueue] finishTransaction:tran];来允许你从支付队列中移除交易。

3\. 真机测试的时候，一定要退出原来的账号(app store 登录的账号退出)，才能用沙盒测试账号。

4\. 请务必使用真机来测试，一切以真机为准。

5\. 项目的Bundle identifier需要与您申请AppID时填写的bundleID一致，不然会无法请求到商品信息。

6\. 沙盒环境测试appStore内购流程的时候，请使用没越狱的设备。

7\. 二次验证，请注意区分宏，测试用沙盒验证，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.使用内购需要哪些资料<br>　　 1张visa银行卡，appid，1张银行卡与苹果三七分打钱用

（1）协议、税务和银行业务

联系人信息：(appid账号人)姓名，邮箱，电话号码，地址（城市、具体街道分行写）

visa银行卡信息：开户行，开户行所在地址，开户行的邮政编码，开户行持有人卡号，开户行持有人姓名

税务信息：1.会问你是不是美国居民选择NO. 2\. 有没有在美国从事商业性活动，选择NO. 之后填写个人或组织名称，所在国家，受益方式(独立开发者选择个人)，居住地址，邮寄地址，声明人，头衔

(2)内购产品id的配置（开发人员配置）

如果是金币或其它消耗品的产品的话用消耗性型项目，参考名称（内购项目，比如金币100),产品id,定价信息，使用内购的快照，显示名称，描述。

(3)用户职能

测试员：添加水箱测试员及沙箱账号，水箱测试账号不能是正常使用的appid账号，直接使用一个没有注册过的邮箱账号即可。

姓名，测试账号密码，appstore地区（必须填对）。

|
四、操作流程图解与代码

1.创建app后填写用户信息

image

功能简介 :

1.我的App主要用于管理自己的App应用，例如编辑资料，上架，下架等。

2.销售和趋势主要是来查看App在各个平台的下载量,收入等方面数据，里面有曲线图等图文结合的方式给我们参考。

3.付款和财务报告显示的是你的收入以及付款等相关信息。

4.iAd主要是跟广告有关，开发者可以登录到Workbench，通过iAd对应用的广告进行控制。

5.用户和职能用于生成相应账号，例如苹果沙盒测试账号。

6.协议，税务和银行业务则是你银行相关账户的信息设置。

流程

1.注册app,填写协议、税务和银行业务

注册app,需要设置Bundle identifier，此个步骤这里就不在写了

填写协议、税务和银行业务

image

<strong>选择申请合同类型</strong>

页面内容：

Request Contracts(申请合同)

Contracts In Effect(已生效合同)。

合同类型：

iOS Free Application(免费应用合同)

iOS Paid Application(付费应用合同)

iAd App NetNetwork(广告合同)

　　1.申请iOS Paid Application合同

image

image

　2. 设置协议税务、银行卡信息

当我们点击申请iOS Paid Application合同后，该合同的状态会变成如下的样子，我们可以看到其中Status为Contact， Bank, Pending Tax,

意思是联系方式、银行和税务信息没有填写。

image

2.1设置联系人信息

如果你没有添加过联系人，你需要通过Add New Contact按钮来添加一个新的联系人。然后指定联系人的职务，职务如下：

Senior Management：高管

Financial：财务

Technical：技术支持

Legal：法务

Marketing：市场推广

如果你是独立开发者，可以全部填你自己一个人。

新增联系人

image

通过新增或之前增加的联系人设置高管等信息

image

待完成后点击Done,返回后状态会变成Edit状态

2.2设置银行卡信息(可以通过银行名称和地址直接上网查询CNAPS Code号，不要问我上那查)

image

确认银行卡信息

image

2.3设置税务信息(1.是美国税务，只需要这个就行，后面的澳大利亚和日本的和我们没的关系)

image

选择U.S Tax Forms，选择后会问你两个问题，第一个问题如下：询问你是否是美国居民，有没有美国伙伴关系或者美国公司，如果没有直接选择No。

image

接下来第二个问题如下：询问你有没有在美国的商业性活动，没有也直接选No。

image

然后填写税务信息

然后填写你的税务信息，包括以下几点：

Individual or Organization Name：个人或者组织名称

Country of incorporation：所在国家

Type of Beneficial Owner：受益方式，独立开发者选个人

Permanent Residence：居住地址

Mailing address：邮寄地址

Name of Person Making ``this Declaration：声明人

Title：头衔

当你填写完所有资料后，合同状态就会变成Processing，笔者凌晨1点左右提交，下午就通过了。

|
具体填写见下图（以下是确认税务信息图）

image

填写完成后效果

image

** 3.配置内购产品ID**

完成以上操作，并且苹果审核完毕之后，就可以配置内购产品了。

登录 iTunesConnect -->我的App 模块找到需要内购的App，最后找到页面如下:

image

|
填写沙箱测试员和添加内购产品注意事项

1、邮箱必须是没有注册或者说关联过appstore的邮箱。

2、密码必须有一个是大写字母有一个是小写字母（苹果规定的,理解）。

3、内购屏幕截图规格必须是312*290，且最低分辨率是72ppi。

4、内购的价格是苹果规定的不能自定义(坑啊)。

|
4.增加内购测试账号

** 4.1 内购测试之前准备**

1、什么是内购测试账号(what)及为什么使用内购测试账号(why)?

iOS应用里面用到了苹果应用内付费（IAP）功能，在项目上线前一定要进行功能测试。测试肯定是需要的，何况这个跟money有关。。。开发完成了之后，如何进行测试呢？难道我测试个内购功能要自己掏钱？就算是也是公司掏钱，但是苹果要吃掉3成的啊，想想如果是99刀的商品，点下购买的时候心里都有点发慌。。。

苹果当然没这么坑了，测试内购，苹果提供了沙盒账号（也叫沙箱账号）的方式。这个沙箱账号其实是虚拟的AppleID，在开发者账号后台的iTune Connect上配置了之后就能使用沙盒账号测试内购，有了沙盒账号，就能体验一把土豪的感觉了，游戏钻石什么的随便充，反正不用我的钱。

注意：你可以把沙盒账号看做是一个虚拟的AppleID，这个AppleID只有进行内购测试的功能。重要，重要，重要，这个虚拟的账号只能在自己的测试号中使用，如果在其它地方如appstore使用的话会提示账号无效之类的话。

2、如何使用内购测试账号(how)？

2.1作用内购账号的前提

1）内购的商品ID，价格等相关信息已经录入到开发者后台了（不然那你买什么）

2）开发者后台已经创建好沙盒测试账号了（下面我们会将如何创建）

3）你要有一部真机（iPhone或iPad都行，别用模拟器就好。而且不能是越狱机）

4）bundleID别搞错了，开发者账号、证书、bundleID要一致

5）如果你是第一次在这个开发者账号上集成内购功能，

请先将iTune Connect上的税务协议都填写好，否则内购时会发现商品ID无效。

重要，如果不添加税务协议会报错，找不到商品。

选择用户和职能就是在协议、税务和银行业务左侧

image

4.2内购测试开始

|
1.在iPhone上安装测试包（必须是打包签名证书或者develop签名证书打的包，不能是从App Store上下载的）

2.退出iPhone的App Store账号（因为我们需要使用沙盒账号登录）。

操作方法一：打开App Store应用首页滑到最下方--选中AppleID--注销

操作方法二：设置--iTunes Store与App Store--选中AppleID--注销

3.不能用沙盒测试帐号来登录appstore官网或去其它已上线平台去支付详见图4.21

4.运行下面代码的demo,传入你创建的产品id(就是在app iTunes Connect ->我的app ->功能 ->app内购买项目添加的商品)，点击充值跳转开始购买详见图4.22

5.再次购买时需要输入测试沙盒账号密码(在用户和职能->沙箱技术测试员创建的测试账号)详见图4.23

6.购买成功反馈详见图4.24

4.21 图

image

4.22 图

image

4.23 图

image

4.24 图

5.代码及业务逻辑
业务逻辑

获取内购列表（从App内读取或从自己服务器读取）
App Store请求可用的内购列表
向用户展示内购列表
用户选择了内购列表，再发个购买请求，收到购买完成的回调（购买完成后会把钱打给申请内购的银行卡内）
购买流程结束后, 向服务器发起验证凭证以及支付结果的请求
自己的服务器将支付结果信息返回给前端并发放虚拟产品
服务端的工作比较简单，分4步：
1. 接收ios端发过来的购买凭证。
2. 判断凭证是否已经存在或验证过，然后存储该凭证。
3. 将该凭证发送到苹果的服务器验证，并将验证结果返回给客户端。
4. 如果需要，修改用户相应的会员权限。
考虑到网络异常情况，服务器的验证应该是一个可恢复的队列，如果网络失败了，应该进行重试。

简单来说就是将该购买凭证用Base64编码，然后POST给苹果的验证服务器，苹果将验证结果以JSON形式返回。

image

代码如下：
/*注意事项：
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) {
//请求事务回调类型，返回的数据

}];
}

iOS开发支付篇——内购(IAP)详解

iOS开发支付篇——内购(IAP)详解

import <Foundation/Foundation.h>

import "STRIAPManager.h"

import <StoreKit/StoreKit.h>

pragma mark - ♻️life cycle

pragma mark - 🚪public

pragma mark - 🔒private

if DEBUG

endif

pragma mark - 🍐delegate

if DEBUG

endif

pragma mark - SKProductsRequestDelegate

if DEBUG

endif

if DEBUG

endif

if DEBUG

endif

if DEBUG

endif

pragma mark - SKPaymentTransactionObserver

if DEBUG

endif

if DEBUG

endif