一.基本信息
1.1訂閱后,每次成功續(xù)期,打開(kāi)App后會(huì)走- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray<SKPaymentTransaction *> *)transactions回調(diào)方法,因此啟動(dòng)就要監(jiān)聽(tīng)[[SKPaymentQueue defaultQueue] addTransactionObserver:self];
并且之后在打開(kāi)時(shí)調(diào)用,一直開(kāi)著App是不行的,不過(guò)我沒(méi)有對(duì)此做什么處理,后面會(huì)說(shuō)到
1.2sandbox的續(xù)期時(shí)間是縮短了很多的
并且會(huì)在5次續(xù)訂(一共6條收據(jù))后自動(dòng)取消
二.驗(yàn)證收據(jù)(調(diào)用apple server的接口)
1.接口調(diào)用
自動(dòng)訂閱的收據(jù)驗(yàn)證接口和其他IAP一樣
沙盒狀態(tài)下使用：https://sandbox.itunes.apple.com/verifyReceipt來(lái)驗(yàn)證
生產(chǎn)環(huán)境下使用：https://buy.itunes.apple.com/verifyReceipt
{
“receipt-data” : “(actual receipt bytes here)”
“password” : “(shared secret bytes here)”
}
receipt-data對(duì)應(yīng)的即下面的receiveString(憑證)
NSURL * receiveUrl = [[NSBundle mainBundle] appStoreReceiptURL];
NSData * receiveData = [NSData dataWithContentsOfURL:receiveUrl];
NSString * receiveString = [receiveData base64EncodedStringWithOptions:NSDataBase64EncodingEndLineWithLineFeed];
password對(duì)應(yīng)的是在App Store connect上創(chuàng)建的秘鑰
關(guān)于秘鑰:
如果創(chuàng)建了自動(dòng)續(xù)訂訂閱,由于接口一樣,不管是消耗型還是訂閱,查單都必須傳password.
2.JSON解析
2.1首先在第一次訂閱或者回復(fù)訂閱(也就是停止連續(xù)訂閱后又買(mǎi)了)后,在- (void)paymentQueue:(SKPaymentQueue *)queue updatedTransactions:(NSArray<SKPaymentTransaction *> *)transactions 回調(diào)中,
可以從SKPaymentTransaction中拿到 tran.originalTransaction.transactionIdentifier,這個(gè)標(biāo)識(shí)符是綁定該appleID的,可以和App server的用戶(hù)系統(tǒng)綁定起來(lái),之后會(huì)繼續(xù)用到.
但是這么做一旦用戶(hù)使用一個(gè)appleId給多個(gè)賬戶(hù)充值,就會(huì)出現(xiàn)一對(duì)多的情況,因此這么解決
首先如果訂閱不取消,是不能再購(gòu)買(mǎi)訂閱的,iOS會(huì)提示已經(jīng)購(gòu)買(mǎi)了該訂閱
然后,如果取消了一個(gè)userid下的訂閱,使用另一個(gè)userid購(gòu)買(mǎi)訂閱,后臺(tái)在拿到original_transaction_id的時(shí)候,去數(shù)據(jù)
庫(kù)查詢(xún)有沒(méi)有綁定了這個(gè)original_transaction_id的userid,有的話(huà),刪除綁定,這樣就可以維持original_transaction_id和userid一對(duì)一的綁定,之后恢復(fù)訂閱也會(huì)給這個(gè)新的userid恢復(fù).
另外每次交易都有一個(gè)transactionIdentifier
for (SKPaymentTransaction * tran in transactions) {
NSString *tranId = tran.transactionIdentifier;
}
這是每筆交易的票據(jù)號(hào),需要傳給后臺(tái)
2.2JSON結(jié)構(gòu)
state :0 表示正常
JSON里有兩個(gè)收據(jù)列表,一個(gè)是receipt -> in_app,一個(gè)是latest_receipt_info,
前面說(shuō)到的receiveString(憑證)是可以一直使用的,但是一直使用同一個(gè)receiveString,拿到的JSON里receipt -> in_app不會(huì)變化,latest_receipt_info會(huì)隨著續(xù)期的期數(shù)而變化,并且會(huì)越來(lái)越多,并且如果使用公共秘鑰,這里面會(huì)包含所有的票據(jù)
前面說(shuō)到的傳給App server的transactionIdentifier,需要作為唯一的票據(jù)號(hào)去驗(yàn)證,
首先對(duì)于非連續(xù)訂閱的其他類(lèi)型:
都是單筆交易,每次拿到的都是新的憑證,因此in_app里都是有對(duì)應(yīng)票據(jù)的,而且我發(fā)現(xiàn)非連續(xù)訂閱的票據(jù)有時(shí)候不會(huì)在latest_receipt_info中出現(xiàn), 因此這些類(lèi)型是遍歷in_app里的票據(jù)
如果找到transactionIdentifier相同的,那么本次交易就是有效的
然后對(duì)于連續(xù)訂閱型:
1.第一次對(duì)賬
遍歷latest_receipt_info里的票據(jù),如果transactionIdentifier相同,那么本次交易就是有效的,找到對(duì)應(yīng)的票據(jù)后,其中最關(guān)鍵的是expires_date_ms這個(gè)時(shí)間戳,這個(gè)和expires_date字符串不相符, expires_date是GMT時(shí)間,少8個(gè)小時(shí),而expires_date_ms轉(zhuǎn)換后是正常的,因此不用把這個(gè)時(shí)間戳再加8小時(shí).
2.之后的對(duì)賬
由于蘋(píng)果會(huì)在到期前充值,充值失敗也會(huì)有回調(diào)通知,所以當(dāng)數(shù)據(jù)庫(kù)中的時(shí)間到期后,再去用之前存的憑據(jù)調(diào)用對(duì)賬接口,
然后遍歷latest_receipt_info根據(jù)product_id,也就是商品id,把連續(xù)訂閱的票據(jù)篩選出來(lái)
現(xiàn)在篩選出來(lái)的這些就是所有的此商品的訂閱票據(jù)了,而且順序是按照時(shí)間排序的,新的在后面,如果不放心,可以自己根據(jù)里面的expires_date_ms(或者其他時(shí)間戳)再排序,然后創(chuàng)建訂單,更新過(guò)期時(shí)間等等操作
官方文檔有每個(gè)字段的含義說(shuō)明
三.狀態(tài)回調(diào)(apple 調(diào)用App server的接口)
這個(gè)接口(post請(qǐng)求)事先在App Store connect配置,在App信息一項(xiàng)里,并且測(cè)試時(shí)可以先填測(cè)試的url,之后再修改,應(yīng)該是立即起效
配置這個(gè)url后,apple會(huì)在以下?tīng)顟B(tài)時(shí)調(diào)用
第一個(gè)是首次訂閱成功
第二個(gè)是取消了訂閱
第三個(gè)是恢復(fù)了訂閱
第四個(gè)也是恢復(fù)了訂閱,在sandbox測(cè)試時(shí),6次收據(jù)之后,重新訂閱,就會(huì)是這個(gè)狀態(tài)
第五個(gè)也是取消了訂閱,在sandbox測(cè)試時(shí),6次收據(jù)之后,就會(huì)變成這個(gè)狀態(tài)
第六個(gè)是各種狀態(tài)改變下都會(huì)調(diào)用,比如說(shuō)首次購(gòu)買(mǎi)會(huì)收到兩次回調(diào),一個(gè)是INITIAL_BUY一個(gè)是DID_CHANGE_RENEWAL_STATUS
上面是一個(gè)6次后自動(dòng)取消的JSON,notification_type屬于第六種.
其中auto_renew_status是false,表示續(xù)訂取消,并且返回了上一次的憑證,可以獲取到期時(shí)間,
并且返回了最關(guān)鍵的original_transaction_id,通過(guò)這個(gè)可以確定是哪個(gè)用戶(hù)做了取消操作
這個(gè)回調(diào)很重要
官方文檔有更詳細(xì)的說(shuō)明
總結(jié)一下
我使用了這種方法去標(biāo)記訂閱的有效期
首次訂閱后App中得到receiveString和,App server存儲(chǔ)receiveString和transactionId,綁定用戶(hù)賬戶(hù),
之后App server去調(diào)用驗(yàn)證收據(jù)接口,根據(jù),獲得original_transaction_id綁定用戶(hù),并且拿到過(guò)期時(shí)間,存儲(chǔ)下來(lái)
快要過(guò)期時(shí),App server再去調(diào)用收據(jù)接口,拿到最新的過(guò)期時(shí)間,然后更新
如果收到了Apple關(guān)于訂閱取消的通知(DID_CHANGE_RENEWAL_STATUS并且auto_renew_status是false),一樣是根據(jù)original_transaction_id更新到期時(shí)間
如果收到了apple關(guān)于恢復(fù)訂閱的通知,也一樣是根據(jù)original_transaction_id更新到期時(shí)間
四.關(guān)于審核
1.由于App的設(shè)計(jì)不同,可能會(huì)要求必須實(shí)現(xiàn)未登錄的訂閱功能,或者說(shuō)游客購(gòu)買(mǎi).
2.自動(dòng)續(xù)訂訂閱是App設(shè)計(jì)的一種商品,在App Store connect創(chuàng)建商品,然后再App中購(gòu)買(mǎi),支付的是現(xiàn)金,不能實(shí)現(xiàn)虛擬幣購(gòu)買(mǎi).
4.充值界面需要顯示出自動(dòng)續(xù)期訂閱的說(shuō)明,以及相關(guān)服務(wù)的協(xié)議(如會(huì)員)的連接,還有自動(dòng)續(xù)期訂閱的協(xié)議的連接
5.App Store connect的App說(shuō)明也需要在最下面加上關(guān)于自動(dòng)訂閱的說(shuō)明,具體可以在App Store找一個(gè)音樂(lè)App或者視頻App看看.
