一,前言
經典文章參考: 1.http://yimouleng.com/2015/12/17/ios-AppStore/ 內購流程 2.http://www.jianshu.com/p/b199a4672608 完成交易后和服務器交互 3.http://www.jianshu.com/p/1ef61a785508 沙盒賬號測試
4.https://www.jianshu.com/p/4f8a854ff427 審核前的配置及注意事項
重點總結:
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.使用內購需要哪些資料 1張visa銀行卡,appid,1張銀行卡與蘋果三七分打錢用
(1)協議、稅務和銀行業務
聯系人信息:(appid賬號人)姓名,郵箱,電話號碼,地址(城市、具體街道分行寫)
visa銀行卡信息:開戶行,開戶行所在地址,開戶行的郵政編碼,開戶行持有人卡號,開戶行持有人姓名
稅務信息:
1.會問你是不是美國居民選擇NO.
2. 有沒有在美國從事商業性活動,選擇NO.
3.之后填寫個人或組織名稱,所在國家,受益方式(獨立開發者選擇個人),居住地址,郵寄地址,聲明人,頭銜
(2)內購產品id的配置 (開發人員配置)
如果是金幣或其它消耗品的產品的話用消耗性型項目,參考名稱(內購項目,比如金幣100),產品id,定價信息,使用內購的快照,顯示名稱,描述。
(3)用戶職能
測試員:添加水箱測試員及沙箱賬號,水箱測試賬號不能是正常使用的appid賬號,直接使用一個沒有注冊過的郵箱賬號即可。
姓名,測試賬號密碼,appstore地區(必須填對)。
四、操作流程圖解與代碼
1.創建app后填寫用戶信息
功能簡介 :
1.我的App主要用於管理自己的App應用,例如編輯資料,上架,下架等。
2.銷售和趨勢主要是來查看App在各個平台的下載量,收入等方面數據,里面有曲線圖等圖文結合的方式給我們參考。
3.付款和財務報告顯示的是你的收入以及付款等相關信息。
4.iAd主要是跟廣告有關,開發者可以登錄到Workbench,通過iAd對應用的廣告進行控制。
5.用戶和職能用於生成相應賬號,例如蘋果沙盒測試賬號。
6.協議,稅務和銀行業務則是你銀行相關賬戶的信息設置。
流程
1.注冊app,填寫協議、稅務和銀行業務
注冊app,需要設置Bundle identifier,此個步驟這里就不在寫了
填寫協議、稅務和銀行業務
選擇申請合同類型
* 頁面內容:
Request Contracts(申請合同)
Contracts In Effect(已生效合同)。
* 合同類型:
iOS Free Application(免費應用合同)
iOS Paid Application(付費應用合同)
iAd App NetNetwork(廣告合同)
1.申請iOS Paid Application合同
2. 設置協議稅務、銀行卡信息
當我們點擊申請iOS Paid Application合同后,該合同的狀態會變成如下的樣子,我們可以看到其中Status為Contact, Bank, Pending Tax,
意思是聯系方式、銀行和稅務信息沒有填寫。
2.1設置聯系人信息
如果你沒有添加過聯系人,你需要通過Add New Contact按鈕來添加一個新的聯系人。然后指定聯系人的職務,職務如下:
* Senior Management:高管
* Financial:財務
* Technical:技術支持
* Legal:法務
* Marketing:市場推廣
如果你是獨立開發者,可以全部填你自己一個人。
新增聯系人
通過新增或之前增加的聯系人設置高管等信息
待完成后點擊Done,返回后狀態會變成Edit狀態
2.2設置銀行卡信息(可以通過銀行名稱和地址直接上網查詢CNAPS Code號,不要問我上那查)
確認銀行卡信息
2.3設置稅務信息(1.是美國稅務,只需要這個就行,后面的澳大利亞和日本的和我們沒的關系)
選擇U.S Tax Forms,選擇后會問你兩個問題,第一個問題如下:詢問你是否是美國居民,有沒有美國伙伴關系或者美國公司,如果沒有直接選擇No。
接下來第二個問題如下:詢問你有沒有在美國的商業性活動,沒有也直接選No。
然后填寫稅務信息
然后填寫你的稅務信息,包括以下幾點:
Individual or Organization Name:個人或者組織名稱
Country of incorporation: 所在國家
Type of Beneficial Owner:受益方式,獨立開發者選個人
Permanent Residence:居住地址
Mailing address:郵寄地址
Name of Person Making
this
Declaration:聲明人
Title:頭銜
當你填寫完所有資料后,合同狀態就會變成Processing,筆者凌晨1點左右提交,下午就通過了。
具體填寫見下圖(以下是確認稅務信息圖)
填寫完成后效果
3.配置內購產品ID
完成以上操作,並且蘋果審核完畢之后,就可以配置內購產品了。
登錄 iTunesConnect -->我的App 模塊找到需要內購的App,最后找到頁面如下:
填寫沙箱測試員和添加內購產品注意事項
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無效。
重要,如果不添加稅務協議會報錯,找不到商品。
選擇用戶和職能就是在協議、稅務和銀行業務左側
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 圖
4.22 圖
4.23 圖
4.24 圖
5.代碼及業務邏輯
業務邏輯
- 獲取內購列表(從App內讀取或從自己服務器讀取)
- App Store請求可用的內購列表
- 向用戶展示內購列表
- 用戶選擇了內購列表,再發個購買請求,收到購買完成的回調(購買完成后會把錢打給申請內購的銀行卡內)
- 購買流程結束后, 向服務器發起驗證憑證以及支付結果的請求
- 自己的服務器將支付結果信息返回給前端並發放虛擬產品
-
服務端的工作比較簡單,分4步:
- 接收ios端發過來的購買憑證。
- 判斷憑證是否已經存在或驗證過,然后存儲該憑證。
- 將該憑證發送到蘋果的服務器驗證,並將驗證結果返回給客戶端。
- 如果需要,修改用戶相應的會員權限。
考慮到網絡異常情況,服務器的驗證應該是一個可恢復的隊列,如果網絡失敗了,應該進行重試。
簡單來說就是將該購買憑證用Base64編碼,然后POST給蘋果的驗證服務器,蘋果將驗證結果以JSON形式返回。
代碼如下 :
/*注意事項:
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) {
//請求事務回調類型,返回的數據
}];
}