iOS In-App Purchase

前言

如果你的 app 涉及到付款的业务,用来获取订阅、游戏内货币、游戏关卡、优质内容的访问权限等,则需要使用苹果的App 内购买项目,苹果会从中抽取三成,如果试图绕过苹果的支付渠道,使用其他的方式支付,会导致 app 被拒绝,没办法,这就是游戏规则。

App Store 审核指南 3
在 App Store 中,您可以通过多种方式让自己的 app 实现盈利。如果您的业务模式并不显而易见,请务必在其元数据和 App Review 备注中加以说明。如果我们无法理解 app 的工作方式,或者 App 内购买项目不是那么一目了然,则审核会有所延误,并可能会导致 app 被拒绝。

  • 如果您想要在 app 内解锁特性或功能 (解锁方式有:订阅、游戏内货币、游戏关卡、优质内容的访问权限或解锁完整版等),则必须使用 App 内购买项目。 App 可使用 App 内购买项目式货币,以便用户在 app 中“打赏”数字内容提供商。App 及其元数据不得包含指引客户使用非 App 内购买项目机制进行购买的按钮、外部链接或其他行动号召用语。

如果支付是为了丰富你的app的内容,则要使用 App 内购。实物类(比如京东一类的)、服务类(比如支付宝、滴滴一类的)的 app 付费与否并不会对 app 本身产生影响,你付费只是因为物权、债权转移或者享受相关服务,这种苹果是不会抽成的。而内购类的,付费与否会对 app 的功能或者人物等级这些产生影响,苹果就会抽成了。

好了言归正传,下面就来介绍一下,怎样在 iOS 中接入 In-App Purchase。

App 内购买项目配置流程

App 内购买项目通过访问 App Store 并安全处理来自用户的付款,将商店直接嵌入您的 App。若要使用 App 内购买项目和 Storekit framework(Storekit 框架),您必须拥有最新的 Apple Developer Program License Agreement(《Apple 开发人员许可协议》)和 Paid Applications agreement(《付费应用程序协议》)

每个开发人员帐户可在该帐户的所有 App 中创建最多 10,000 个 App 内购买项目产品。App 内购买项目共有四种类型:消耗型、非消耗型、自动续期订阅和非续期订阅。

每个产品都必须在 iTunes Connect 中添加到与其关联的 App 中。

  1. 签署 Paid Applications agreement(《付费应用程序协议》)

    若要提供 App 内购买项目,您必须在 iTunes Connect 中签署 Paid Applications agreement(《付费应用程序协议》)。
    签署协议:
    a. 在 itunesconnect 首页上,点按“协议、税务和银行业务”。
    b. 在“Request Contracts(请求合约)”部分找到您想要签署的合约,在右侧点按“Request(请求)”。
    c. 在对话框中,阅读并接受条款(点按复选框),然后点按“Submit(提交)”。
    d. 点按“完成”。
    已签署的合约将显示在“Master Agreements(主协议)”部分。


协议的状态
  1. 在 iTunes Connect 中配置 App 内购买项目

    接下来,在 iTunes Connect 中为您的 App 配置 App 内购买项目产品。如果您尚未创建 App,请先创建 App。每一个 App 内购买项目产品都与一个特定的 App 相关联,因此为某一 App 使用而创建的产品无法在其他 App 中使用。
    a. 在 itunesconnect 首页上,点按“我的 App”,然后选择与该 App 内购买项目相关联的 App。
    b. 在工具栏中,点按“功能”,然后在左列中点按“App 内购买项目”。
    c. 若要添加 App 内购买项目,请前往“App 内购买项目”,并点按“添加”按钮(+)。


    d. 选择“消耗型项目”、“非消耗型项目”或“非续订订阅”,并点按“创建”。有关自动续订订阅的信息,请参见创建自动续期订阅
    e. 添加参考名称、产品 ID 和本地化显示名称。
    f. 点按“存储”或“提交以供审核”。

  1. 在 Xcode 中启用 App 内购买项目

    在 Xcode 中 Add a Capability 为您的 App 启用 App 内购买项目功能。确保您的 App 在 Xcode 中的套装标识符和产品标识符与您开发人员帐户中针对该 App 的标识符以及您在 iTunes Connect 中配置的 App 内购买项目相匹配。


  1. 设计并创建您的 App 内购买项目
    创建您的 App 内购买项目需要使用到 StoreKit 框架,此框架代表您的应用程序连接到App Store,以安全处理来自用户的付款,提示他们授权付款。 该框架然后通知您的应用程序,该应用程序向用户提供购买的项目。

内购的大致过程:
a、客户端获取内购的产品ID列表。如果你的应用具有固定的产品ID列表(例如通过应用内购买来移除广告或启用功能),可将该列表保存在应用包中。 如果产品ID列表可能会变动(例如支持其他级别或人物的游戏),则需要从你的服务器获取产品ID列表。

b、客户端获产品ID列表后,根据你选择的产品ID去苹果服务器发起支付请求,支付成功后,苹果返回给你一个收据,收据包含你这次交易的全部信息,产品id,交易号,时间等。

c、拿到收据之后,需要做校验。拿到收据之后发送到你的后台,做base64加密(苹果要求加密),后台发送给苹果服务器做收据的校验,苹果验证成功后会返回收据的json形式,然后取出里面的产品id等做对比,对比成功后,后台返回 app 客户端所购买的产品。

相关的代码:

//导入库文件
#import <StoreKit/StoreKit.h>
@interface ...()<SKProductsRequestDelegate, SKPaymentTransactionObserver>
//根据产品的ID,从Apple获取的产品的详细信息
// Custom method
- (void)validateProductIdentifiers:(NSArray *)productIdentifiers
{
    SKProductsRequest *productsRequest = [[SKProductsRequest alloc]
                    initWithProductIdentifiers:[NSSet setWithArray:productIdentifiers]];
 
    // Keep a strong reference to the request.
    self.request = productsRequest;
    productsRequest.delegate = self;
    [productsRequest start];
}
 
// SKProductsRequestDelegate protocol method
- (void)productsRequest:(SKProductsRequest *)request
     didReceiveResponse:(SKProductsResponse *)response
{
    self.products = response.products;
 
    for (NSString *invalidIdentifier in response.invalidProductIdentifiers) {
        // Handle any invalid product identifiers.
    }
 
    [self displayStoreUI]; // Custom method
}
//获取到了商品的详细信息,然后根据该详细信息发起对商品的购买请求了
SKProduct *product = <# Product returned by a products request #>;
SKMutablePayment *payment = [SKMutablePayment paymentWithProduct:product];
[[SKPaymentQueue defaultQueue] addTransactionObserver:self];
[[SKPaymentQueue defaultQueue] addPayment:payment];
//购买结果回调
- (void)paymentQueue:(SKPaymentQueue *)queue
 updatedTransactions:(NSArray *)transactions
{
    for (SKPaymentTransaction *transaction in transactions) {
        switch (transaction.transactionState) {
            // Call the appropriate custom method for the transaction state.
            case SKPaymentTransactionStatePurchasing:
               //该交易正在由App Store处理。
                break;
            case SKPaymentTransactionStateDeferred:
                //该交易处于队列中,但其最终状态正在等待“要求购买”等外部操作。 
                //更新您的用户界面以显示延迟状态,并等待另一个指示最终状态的回调。
                break;
            case SKPaymentTransactionStateFailed:
                //交易失败
                break;
            case SKPaymentTransactionStatePurchased:
               //App Store已成功处理付款。 
                break;
            case SKPaymentTransactionStateRestored:
                //恢复用户先前购买的内容。 可查看originalTransaction属性以获取有关原始购买的信息。
                break;
            default:
                // For debugging
                NSLog(@"Unexpected transaction state %@", @(transaction.transactionState));
                break;
        }
    }
}
//交易成功,与服务器比对
- (void)completeTransaction:(SKPaymentTransaction *)transaction
{
    //目前苹果公司提倡的获取购买凭证的方法
    NSURL *receiptUrl = [[NSBundle mainBundle] appStoreReceiptURL];
    NSData *receiptData = [NSData dataWithContentsOfURL:receiptUrl];
    //base64位的产品验证码单,base64是服务端和苹果进行校验所必须的,苹果的文档要求凭证经过Base64加密
    NSString * transactionReceiptString = [receiptData base64EncodedStringWithOptions:0];
    //将加密后的transactionReceiptString发送给后台服务端进行校验,在此之前,记得先保存购买凭证
    //完整结束此次在App Store的交易,没有这句代码的调用,下次购买会提示已经购买该商品
    [[SKPaymentQueue defaultQueue] finishTransaction: transaction];
}

可能会遇到问题:
查询产品是,得不到产品的信息
a、App的App ID和内购项目的App的App ID不对应
b、没有填完银行、税务信息,如果信息不完善,IAP的功能就无法测试,也获取不到商品的信息。

  1. 测试 App 内购买项目

    Apple 提供了一种名为“沙箱技术”的测试环境,以便您测试您的 App 内购买项目,且不会产生费用。在沙箱技术环境中测试 App 内购买项目时,使用的是特殊的测试用户帐户,而不是您常规的 iTunes Connect 帐户。请参见“创建沙箱技术测试员帐户”。

    然后,通过使用您的 App 购买 App 内购买项目来测试您代码的各部分,以验证您已正确将其实施。

  2. 在 App Store 上发布您的 App 和 App 内购买项目

    当您完成 App 内购买项目的测试后,您便可以将其提交以供审核。检查 App 的 App 内购买项目状态,以确保您没有遗漏信息,且已为 App 内购买项目选择了定价。当您提交您的 App 作为 App 审核过程的一部分时,产品将会被审核。

References

In-App Purchase for Developers
In-App Purchase Programming Guide

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,029评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,395评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,570评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,535评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,650评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,850评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,006评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,747评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,207评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,536评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,683评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,342评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,964评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,772评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,004评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,401评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,566评论 2 349

推荐阅读更多精彩内容