前言
如果你的 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 中。
。
-
签署 Paid Applications agreement(《付费应用程序协议》)
若要提供 App 内购买项目,您必须在 iTunes Connect 中签署 Paid Applications agreement(《付费应用程序协议》)。
签署协议:
a. 在 itunesconnect 首页上,点按“协议、税务和银行业务”。
b. 在“Request Contracts(请求合约)”部分找到您想要签署的合约,在右侧点按“Request(请求)”。
c. 在对话框中,阅读并接受条款(点按复选框),然后点按“Submit(提交)”。
d. 点按“完成”。
已签署的合约将显示在“Master Agreements(主协议)”部分。
-
在 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. 点按“存储”或“提交以供审核”。
-
在 Xcode 中启用 App 内购买项目
在 Xcode 中 Add a Capability 为您的 App 启用 App 内购买项目功能。确保您的 App 在 Xcode 中的套装标识符和产品标识符与您开发人员帐户中针对该 App 的标识符以及您在 iTunes Connect 中配置的 App 内购买项目相匹配。
-
设计并创建您的 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的功能就无法测试,也获取不到商品的信息。
-
测试 App 内购买项目
Apple 提供了一种名为“沙箱技术”的测试环境,以便您测试您的 App 内购买项目,且不会产生费用。在沙箱技术环境中测试 App 内购买项目时,使用的是特殊的测试用户帐户,而不是您常规的 iTunes Connect 帐户。请参见“创建沙箱技术测试员帐户”。
然后,通过使用您的 App 购买 App 内购买项目来测试您代码的各部分,以验证您已正确将其实施。
-
在 App Store 上发布您的 App 和 App 内购买项目
当您完成 App 内购买项目的测试后,您便可以将其提交以供审核。检查 App 的 App 内购买项目状态,以确保您没有遗漏信息,且已为 App 内购买项目选择了定价。当您提交您的 App 作为 App 审核过程的一部分时,产品将会被审核。
References
In-App Purchase for Developers
In-App Purchase Programming Guide