iOSサブスクリプションのテストを、3つの環境で確実に進める方法
購入・更新・期限切れ・復元・キャンセルは、環境ごとに挙動が変わります。開発者用サンドボックス、TestFlight、本番環境を役割分担して使い、公開前に購入フローを通しで確認する流れをまとめました。
使い分けの全体像
テストは3段階で考えるのが安全です。開発者用サンドボックスは開発中の素早い確認、TestFlightは本番用サンドボックスで実アカウントに近い流れの確認、本番環境は公開前後で実際の課金や管理まで確認する段階です。環境ごとの違いを前提に、同じ購入フローを各段階で繰り返します。
開発者用サンドボックス:準備と注意点
Xcodeで開発者ビルドを作り、プロビジョニング済みデバイスで動かします。デバイス種別ごとに最大100台、合計500台までが上限です。新しいサンドボックスアカウントは、まずアプリ内で購入を試みてサインインします。その後は設定アプリのSandbox Accountから切り替えられます。誤って本番のApp Storeで使うと、そのアカウントはサンドボックスで使えなくなるため、新しいアカウントを作り直すのが確実です。購入時に何度もサインインを求められるのはサンドボックス特有の動作で、表示のたびにサインインすれば最終的に認証が完了します。
短縮期間と自動更新の読み方
この環境は信頼性が低く、コードが正しくても問題が起きることがあります。エラー処理の見直しには役立ちますが、公開前に購入フローを通しで確認できる状態にしておくことが前提です。期間は大幅に短縮され、購入・更新・失効を繰り返し試せます。自動更新はアカウントごとに最大12回までで、回数はランダムです。アプリを閉じていても更新は進み、再起動時に未処理のトランザクションが処理されます。最新レシートを確認したい場合はアプリを閉じて開き直してください。サンドボックスではキャンセルや払い戻し、購読管理の直接テストはできません。
サンドボックスで試す具体的な流れ
月額購読を登録し、アプリを閉じて20分待って再起動すると、まだ有効なはずです。さらに20分待つと、購入から約40分後に未購読に戻り、再登録できる状態になります。期限切れ後の復元では、35〜40分待って未購読を確認し、購入を復元を押すと、アクティブな購読は見つからず、その旨の表示が期待できます。有効期間中の復元は、購入後にボタンやジェスチャーで未購読に戻してから行い、35分の期間が終わる前に復元すれば購読状態に戻ります。複数デバイスでは、デバイスAで登録し、失効前にデバイスBへ同じサンドボックスアカウントでインストールして復元します。キャンセルは設定アプリの管理画面から行い、10分待って再起動するとアクティブな購読は検出されません。アップグレードやダウングレードはiOS 14以降は管理画面で試せます。ダウングレード後は5〜10分待ってアプリを起動し、新しいプロダクトへの購読を確認します。購入中断はApp Store Connectで有効化し、利用規約をキャンセルした場合は購入が解除されず、同意して再購入すると有効な購読が反映されます。
無料トライアルの対象可否
初回オファー付きプロダクトでは、新規サンドボックステスターで正しい文言が出るか確認し、購入してすぐキャンセルして短縮期間の終了を待ちます。その後ペイウォールを開き、対象外として無料トライアルの文言が出ないことを確認します。同じグループの製品で初回オファーを使ったアカウントは対象外になるため、繰り返し試す場合は利用資格のリセット手順に従います。
StoreKitTest:速い確認と最終確認の分担
iOS 14以降はXcode上でStoreKit全体をローカルに模擬でき、サンドボックスより速く試せます。コンテンツのロックやアンロックなど一部機能の確認に向きますが、最終確認はサンドボックスで行い、App Store Connectの設定が効くことを確かめます。更新間隔は構成ファイルのSubscription Renewal Rateから変更でき、デフォルトはリアルタイム更新です。
TestFlight:本番に近い流れと伝え方
TestFlightは実アカウントを使い、本番用サンドボックスで課金処理を行います。実際に課金されることはありませんが、ペイウォール表示から購入フローまで確認できます。2024年12月以降、更新頻度は期間にかかわらず24時間に1回となり、ライフサイクルの確認には時間がかかります。効率化のため購入状態を切り替えるボタンや隠しジェスチャーを入れると便利ですが、本番ビルドではビルドフラグで必ず外し、リリースノートに明記します。TestFlightビルドは公開ビルドと同一にし、バックエンドが分かれる場合は本番バックエンドに接続します。ベータテスターに価格テストやペイウォールのA/Bテストを頼むのは避けてください。課金できないうえ、関心の高い層に偏ります。ペイウォールの流れを体験してもらう場合は、全機能をアンロックしたうえで手順をリリースノートに書き、無料状態に戻す操作も用意すると協力を得やすくなります。
本番環境:公開前と公開後の確認
未公開アプリでも、ベータ版を審査に提出し手動リリースに設定すれば本番で試せます。承認済み無料アプリにはプロモコードを発行でき、App Storeでダウンロードして購読登録できます。実際に課金され、購読管理もできます。プロモコードの購読は自動更新されません。公開前にダウンロードした場合はレシートが正しくないことがあり、購入で更新されます。新しいプロダクトはアプリやアップデートより遅れて購入可能になることがあり、承認後24時間以上待ってから再テストしてください。本番では更新や期限を待つのは現実的でないため、サンドボックスで正しく動けば本番でも動く前提で確認します。キャンセルはApp Storeアプリで操作し、1〜2分待って再起動すると自動更新が無効になります。返金はAppleへリクエストし、1日待って再起動すると非購読へ切り替わります。復元はアプリを削除して再インストールし、必要に応じて購入を復元を押します。サブスクリプションオファーはサンドボックスでは失効後でないと使えず、本番ではアクティブや一時離脱の購読者も使えます。
コード・オファー・レシート・表示の補足
プロモコードの購読は自動更新されず、既存購読者へ渡すと現在の購読がキャンセルされます。有料アプリではダウンロード用コードが別途必要で、レシートからはプロモコード利用を追跡できません。オファーコードはアプリ内やApp Storeで引き換えられ、注意点は少ない一方、サンドボックスで完全には試せません。サンドボックスで購入が動けば本番でも動くと見込めます。TestFlight招待は任意のメール宛で送れ、リンクをタップしたデバイスのApp Storeアカウントに関連付きます。レシートがバンドルにない場合は自動取得せず、購入を復元する操作を用意します。新しいプロダクトは承認後最大24時間反映に時間がかかるため、ペイウォールはリモートで切り替えられる設計にします。ペイウォールに必須なのは購読名、期間、価格で、利用規約やプライバシーポリシーのリンクはアプリ内のどこかに置きます。
QAチェックリスト
開発者サンドボックスとTestFlightでは、購入、自動更新と期限切れ、期限切れ後の復元、有効期間中の復元、複数デバイスでの復元を確認します。本番では、リリース前とリリース日に購入できること、キャンセル、返金、購入復元を確認します。チェックを終えたら、StoreKitTestだけで済ませず実際のサンドボックスでも定期的に確認してください。
| App Storeの期間 | サンドボックスの期間 | TestFlight |
|---|---|---|
| 3 days | 2 minutes | 1 day |
| 1 week | 3 minutes | 1 day |
| 1 month | 5 minutes | 1 day |
| 2 months | 10 minutes | 1 day |
| 3 months | 15 minutes | 1 day |
| 6 months | 30 minutes | 1 day |
| 1 year | 1 hour | 1 day |
Captured durations; TestFlight column reflects the December 2024 change to once every 24 hours regardless of subscription period.
| アプリの種類 | App Store | あなたのバックエンド |
|---|---|---|
| Sandbox | Sandbox | Staging |
| TestFlight | Production Sandbox | Production |
| App Store | Production | Production |
Typical setup captured in source; confirm your own staging and production split before applying.
Frequently asked questions
サブスクリプションの更新間隔は環境でどう違いますか?
開発者用サンドボックスでは期間が短縮され、月額は5分、年額は1時間です。TestFlightでは2024年12月以降、期間にかかわらず24時間に1回です。StoreKitTestはデフォルトでリアルタイム更新で、構成ファイルから変更できます。
サンドボックスで購入復元がうまくテストできないのはなぜですか?
サンドボックスでは購入までレシートが生成されません。そのため有効期間中に復元を試すには、アプリを未購読に戻すボタンやジェスチャーを用意しておく必要があります。
プロモコードで付与した購読はどう扱われますか?
プロモコードのサブスクリプションは自動更新されません。既存の有料購読者に無料コードを渡すと現在の購読がキャンセルされ、自動更新なしの無料期間に置き換わります。
レシートが存在しない場合はどう対処しますか?
レシートがバンドルにない場合、自動取得はパスワード入力を求められキャンセルされがちです。わかりやすい場所に購入を復元する操作を用意し、ユーザー自身が取得できるようにします。