本文彙整了應用內購(In-App Purchase,以下簡稱 IAP)開發與除錯過程中最常見的問題。
不需要。
但要注意:在 App 準備好送審之前,不要把開發中的二進位檔上傳到 iTunes Connect。一旦二進位檔出現在 iTunes Connect,即使功能還不完整,App Review 也會去審查它,被拒的機率很高。而且如果 App Review 拒掉了最新的二進位檔,IAP 測試就會失敗。一個變通做法是:先上傳一個不含 IAP 功能的版本通過審核,等二進位檔過審後再測 IAP。
先在 Xcode 或 iTunes Connect 中確認 App 目前的 Bundle ID(可參考 About Bundle IDs)
依 Registering App IDs 的步驟 1-6 與 8-10,更新萬用字元 App ID 使其支援 IAP
iOS:iOS 4.2
OS X:OS X 10.9
兩種情況:在使用者擁有的其他裝置上安裝,或在已移除該 App 的裝置上重新安裝。這兩種情況下,只能用 SKPaymentQueue 的 restoreCompletedTransactions 來恢復自動續訂與非消耗型商品。
請參考 Configuring a Product。
因為你在裝置上登入 App Store 時用的是測試帳戶。一旦用這個帳戶進入購買流程,Sandbox 就會判定帳戶不可用。解法:在「設定」App 裡登出目前帳號,於 iTunes Connect 建立一個新的測試帳戶,然後在 Store Kit 提示確認購買時改用這個帳戶。
可能由以下一或多個原因造成:
Sandbox 無法連通
App 缺少 bundle version(CFBundleVersion),可參考 Setting the Version Number and Build String
App 跑在模擬器上——模擬器不支援應用內購買
你要購買的商品已下架,可參考 Query the App Store for product information before presenting your app's store UI
這代表你用測試帳號登入了 iTunes Store。解法同上:在「設定」裡登出目前帳號,於 iTunes Connect 建立新的測試帳戶,並在 Store Kit 提示購買時使用它。
這不是錯誤,而是提示:你正在購買一個已經買過的非消耗型商品,不需要再付一次錢。
原因是 App 沒有呼叫 SKPaymentQueue 的 finishTransaction:。呼叫它能從購買佇列中移除該筆交易。
因為 Store Kit 提示購買時,你用的是一般 iTunes 帳戶。解法:在「設定」裡登出 App Store,改用 Sandbox 測試帳戶。
你在 iTunes Connect 把 IAP 本地化成多語言,但 localizedDescription 與 localizedTitle 總是回傳英文,即使測試裝置的語言並非英文。
原因在於:這兩個屬性回傳的語言是依「目前 iTunes Store 的語言」決定,而不是裝置設定的語言。舉例來說,若你在 iTunes Connect 為 IAP 做了德文本地化,但用英文測試帳號登入,那麼兩者都會回傳英文。想拿到德文,就得用德語測試帳號登入測試裝置。
Sandbox 測試或 App 審核中:https://sandbox.itunes.apple.com/verifyReceipt
已過審上架 App Store:https://buy.itunes.apple.com/verifyReceipt
建議的流程是:先用正式 URL 驗證,若收到 21007 狀態碼再改用 Sandbox URL。這樣做的好處是,無論 App 處於測試、審核中還是已上架,你都不必在兩個 URL 之間來回切換。
21007 代表這是一張 Sandbox 憑證,卻被送到正式服務驗證;0 則代表驗證成功。
原因是 App 裡缺少 OS X App Store 的憑證。如何從 App 中取得憑證,請參考 Receipt Validation Programming Guide。
可能原因:
在 iOS App 裡,你沒有對憑證資料做 base64 編碼
送到 App Store 的內容不是 JSON 格式。以下是一份正確的自動續訂驗證 JSON:
{
"receipt-data" : "...",
"password" : "..."
}若 App 是在購買成功後才驗證憑證,請檢查是否使用了正確的 App Store URL。細節見「驗證憑證該用哪個 URL?」。
空的 in_app 代表 Store Kit 沒有為目前使用者記錄任何交易。可能是 App 的憑證還沒更新——此時 App 應提示使用者尚未取得憑證,詢問是否刷新。若使用者同意,App 可用 SKReceiptRefreshRequest 更新憑證;此時若 Store Kit 已有購買記錄,憑證的 in_app 陣列就會出現該項目。細節見 Refreshing the App Receipt。
這是已知的 bug。解法是改用 Application Loader 上傳含託管內容的包:
在 Xcode 的 Archives Organizer 中,選取包含託管內容的 archive
點 Export
在 dialog 中選擇「Export as an Installer Package」
點 Next 產生,再選 Export 存檔(副檔名為 .pkg)
用 Application Loader 上傳這個包(參考 Using Application Loader)
下圖示範了產生託管內容包的步驟,數字對應上述流程。

在 iTunes Connect 關閉目前自動續訂商品的「Clear for Sale」,把它從程式碼中移除。此舉會停止自動續訂並寄信通知使用者。切記:你必須繼續提供使用者已付費的內容直到訂閱期結束,而且舊的自動續訂商品都是可恢復的。例如使用者 4 月 1 日買了一個月,但商品 4 月 19 日下架,你仍必須提供內容到 5 月 1 日。
建立一個新的 IAP 商品類型,並更新二進位檔來使用它(參考 Creating In-App Purchase Products)。這步不能省,因為 IAP 類型一旦建立就無法更改。
在 App Store 驗證 App 的憑證,再判斷是否需要向使用者開放對應功能(參考 Receipt Validation Programming Guide)。
用憑證中的 Subscription Expiration Date(expires_date)欄位判斷。
假設你決定:購買一個月訂閱並願意分享個人資訊的使用者,可享 7 天免費試用。Store Kit 給你的憑證裡,expires_date 會是 7 天加 1 個月。首次購買後,訂閱會在 1 個月零 7 天後到期,之後每月自動續訂。
只要 App 有一個穩定的交易觀察者,在啟動或從背景恢復時都會收到所有自動續訂提醒。參考 Add a transaction queue observer at application launch。
可能由以下一或多個原因造成:
沒有使用 Explicit App ID
你最新提交到 iTunes Connect 的二進位檔被 Apple 拒了
沒有把 iTunes Connect 中在售的 IAP 產品設為清除
沒有使用與正確 App ID 關聯的 Provisioning Profile 來簽署
修改了商品,但變更尚未在所有 App Store 伺服器生效
沒完成所有財務相關表單(參考 Contracts, Tax, and Banking)
商品由 Apple 託管,但內容尚未上傳到 iTunes Connect。若內容還沒準備好,可在 iTunes Connect 關閉「Hosting Content with Apple」,等內容就緒後再重新開啟
iTunes Connect 中設定的商品識別碼,與 App 裡 SKProductsRequest 使用的不一致(參考 QA1329, 'In-App Purchase Product Identifiers')
可能原因:
你的商品有未完成的交易。若付費佇列裡還有未完成交易,恢復流程不會回傳商品。參考 Finish the transaction。
你先前根本沒有購買過任何非消耗型、自動續訂或免費訂閱商品。
你想恢復的商品類型本身不可恢復。restoreCompletedTransactions 只能恢復非消耗型商品、自動續訂與免費訂閱。
App 的 CFBundleVersion 沒有依規範設定。它應該是由點號分隔的三段無號整數組成的字串。參考 Setting the Version Number and Build String。
補充:若沒有可恢復的產品,Store Kit 不會呼叫 paymentQueue:updatedTransactions:。
App Distribution Guide
iTunes Connect Developer Guide
In-App Purchase Programming Guide
Receipt Validation Programming Guide
Getting Started with In-App Purchase on iOS and OS X
Technical Note TN2387 In-App Purchase Best Practices
In-App Purchase Configuration Guide for iTunes Connect
Technical Q&A QA1329, 'In-App Purchase Product Identifiers'