💭 iOSアプリのサブスクリプションを検証したいけど、自分のApple IDで課金するのは避けたい...

そんな方向けの記事になっています。

▼記事の内容

• サンドボックスアカウントとは何か
• サンドボックスアカウントの作成方法
• 利用規約への同意手順（重要）
• 実際の検証方法と注意点
• よくあるトラブルと解決法

記事の信頼性

この記事を書いている私は、実際にiOSアプリ開発を行っており、サブスクリプション機能の実装と検証を経験しています。サンドボックス環境での検証は、App Store審査前に必ず通過する重要なプロセスです。

iOSアプリでサブスクリプション機能を実装する際、本番のApple IDで課金テストをすることは絶対に避けるべきです。そのために用意されているのが「サンドボックスアカウント」という検証専用のアカウントです。

この記事では、サンドボックスアカウントの作成から実際の使用方法まで、ステップバイステップで解説していきます。

それでは、3分ほどでサクッと読めます。

🤔 サンドボックスアカウントとは

サンドボックスアカウントは、App Store Connectで作成できる検証専用のテストアカウントです。

実際の課金は発生せず、アプリ内課金やサブスクリプションの動作を安全にテストできます。

サンドボックスアカウントの特徴

• 課金が発生しない: テスト環境専用なので実際のお金は使いません
• 高速な検証: サブスクリプションの期間が実際よりも短縮されます（例: 1ヶ月 → 5分）
• 繰り返しテスト可能: 何度でも購入・キャンセル・復元のテストができます
• 本番環境とは完全分離: 本番のApp Storeには影響しません

なぜ必要なのか？

iOSアプリのサブスクリプション機能を実装する際、以下のような検証が必要になります。

• サブスクリプションの購入フロー
• 購読状態の確認
• 自動更新の動作
• サブスクリプションのキャンセル
• 購入の復元機能

これらを自分のメインのApple IDでテストするのは危険です。誤って課金してしまったり、テストデータが本番アカウントに残ってしまう可能性があります。

📋 サンドボックスアカウントの作成方法

それでは、実際にサンドボックスアカウントを作成していきましょう。

STEP1: App Store Connectにアクセス

1. App Store Connectにアクセス
2. デベロッパーアカウントでログイン

STEP2: サンドボックステスターの作成

Webブラウザから作成

1. App Store Connectのトップページで「ユーザーとアクセス」をクリック
2. 上部タブから「Sandbox」を選択
3. 「+」ボタンまたは「テスターを追加」をクリック
4. 以下の情報を入力します

入力項目

• メールアドレス: 実際に存在しなくてもOK（例: test-sandbox@example.com）
• パスワード: 8文字以上、英数字と記号を含む
• 名: テスト用の名前
• 姓: テスト用の苗字
• 国または地域: 日本（またはテストしたい地域）

5. 「保存」をクリック

STEP3: 作成完了の確認

サンドボックステスターの一覧に、作成したアカウントが表示されていればOKです。

重要ポイント

• メールアドレスは実在しなくても大丈夫です
• ただし、覚えやすいアドレスにすることをおすすめします（後で使います）
• パスワードも必ずメモしておきましょう

✅ 利用規約への同意（超重要！）

サンドボックスアカウントを作成しただけでは使えません。利用規約への同意が必要です。

この手順を忘れると、アプリ内課金のテスト時に「このApple IDはまだApp Storeで使用されたことがありません」というエラーが出ます。

STEP1: Apple IDサイトでログイン

1. ブラウザで https://account.apple.com/ にアクセス
2. 作成したサンドボックスアカウントのメールアドレスとパスワードでログイン
3. 利用規約が表示されるので、すべて同意してください

注意点

• 必ずサンドボックスアカウントでログインしてください
• 自分のメインのApple IDでログインしないように注意！

STEP2: iCloud.comでも同意

続いて、iCloud.comでも利用規約に同意します。

1. ブラウザで https://www.icloud.com/ にアクセス
2. サンドボックスアカウントでログイン
3. ここでも利用規約が表示されるので、同意してください

これで、サンドボックスアカウントの準備が完了しました。

なぜ2箇所で同意が必要なのか？

Apple IDとiCloudは密接に連携しており、それぞれで利用規約への同意が必要になります。両方で同意しないと、アプリ内課金のテスト時にエラーが発生する可能性があります。

🧪 実際の検証方法

サンドボックスアカウントの準備ができたら、実際にアプリで検証してみましょう。

事前準備: デバイスからサインアウト

重要: テストを開始する前に、iOSデバイスのApp Storeから一度サインアウトしてください。

1. iOSデバイスの「設定」アプリを開く
2. 一番上の自分の名前をタップ
3. 「メディアと購入」をタップ
4. 「サインアウト」をタップ

注意: ここではApp Storeからのみサインアウトします。iCloudからサインアウトする必要はありません。

テスト手順

STEP1: アプリをビルドして実機にインストール

開発中のアプリを実機にインストールします。

重要ポイント

• Xcode 12以降では StoreKit設定ファイル（.storekitファイル）を使うことで、シミュレータでも基本的なテストが可能です
• ただし、最終的な検証は必ず実機で行うことを強く推奨します
• 実機でのテストが最も本番環境に近い動作を確認できます
• ビルド方法はフレームワーク（ネイティブiOS、React Native、Flutterなど）によって異なります

STEP2: サンドボックスアカウントでサインイン

アプリを起動し、サブスクリプション購入画面に移動します。プランを選択して「購入」をタップすると、Apple IDのサインイン画面が表示されます。

ここで重要: 作成したサンドボックスアカウントのメールアドレスとパスワードを入力してください。

絶対にやってはいけないこと

• メインのApple IDでサインインしない
• 「設定」アプリから事前にサンドボックスアカウントでサインインしない（購入時にその場でサインインする）

STEP3: 購入フローの確認

サインインすると、購入確認ダイアログが表示されます。

• 「環境: Sandbox」という表示があることを確認
• 「購入」をタップ
• 実際の課金は発生しません

STEP4: 購入完了を確認

アプリ側で購入完了の処理が実行されることを確認します。

• 購読状態が「有効」になっているか
• プレミアム機能が使えるようになっているか
• レシート検証が正しく動作しているか

⏱️ サンドボックス環境の期間短縮

サンドボックス環境では、サブスクリプションの期間が大幅に短縮されます。

本番環境	サンドボックス環境
1週間	3分
1ヶ月	5分
2ヶ月	10分
3ヶ月	15分
6ヶ月	30分
1年	1時間

これにより、以下のテストが短時間で可能になります

• 自動更新の動作確認（5分待つだけ）
• サブスクリプション期限切れの動作
• 再購読の処理

注意点

• サンドボックスでは最大6回まで自動更新されます
• 6回更新後は自動的にキャンセルされます

⚠️ よくあるトラブルと解決法

エラー1: 「このApple IDはまだApp Storeで使用されたことがありません」

原因: 利用規約に同意していない

解決法

1. https://account.apple.com/ でサンドボックスアカウントでログイン
2. https://www.icloud.com/ でもログインして利用規約に同意
3. デバイスを再起動
4. 再度テストを実行

エラー2: 購入ができない・エラーが出る

原因1: メインのApple IDでサインインしている

解決法

1. 「設定」→「App Store」からサインアウト
2. アプリ内で購入を試みた時に表示されるダイアログでサンドボックスアカウントを入力

原因2: サブスクリプション商品IDが正しく設定されていない

解決法

1. App Store Connectでサブスクリプション商品を確認
2. Xcodeのプロダクト IDと一致しているか確認
3. 商品のステータスが「Ready to Submit」または「承認済み」になっているか確認

エラー3: 「Cannot connect to iTunes Store」

原因: ネットワーク設定またはサンドボックス環境への接続問題

解決法

1. Wi-Fi接続を確認（モバイルデータではなくWi-Fiを使用）
2. デバイスを再起動
3. Appleのシステム状況ページを確認（障害が発生していないか）

エラー4: レシート検証が失敗する

原因: サンドボックス環境用の検証URLを使用していない

解決法

レシート検証では、環境に応じて異なるURLを使用する必要があります。

// 本番環境
let productionURL = "https://buy.itunes.apple.com/verifyReceipt"

// サンドボックス環境
let sandboxURL = "https://sandbox.itunes.apple.com/verifyReceipt"

推奨実装: まず本番URLで検証を試み、ステータスコード21007が返ってきたらサンドボックスURLで再試行する方法（StoreKit 1）

func verifyReceipt(receiptData: Data) {
    // まず本番環境で検証
    verifyWithURL(productionURL, receiptData: receiptData) { result in
        if result.status == 21007 {
            // サンドボックス環境のレシートの場合
            verifyWithURL(sandboxURL, receiptData: receiptData) { sandboxResult in
                // サンドボックス環境での検証結果を処理
            }
        }
    }
}

StoreKit 2について

上記のコード例は従来のStoreKit 1に基づくものです。Appleは現在、よりモダンで安全なStoreKit 2の使用を推奨しています。

StoreKit 2の主な特徴：

• async/awaitを活用したシンプルなAPI
• Apple署名のJWS（JSON Web Signature）形式のトランザクション情報
• サーバー側の実装が簡素化される
• より安全なレシート検証

新規プロジェクトでは、StoreKit 2の使用を検討することをおすすめします。詳細はApple公式ドキュメントをご確認ください。

🔄 サンドボックスアカウントの管理

複数アカウントの作成

異なる地域や条件でテストしたい場合、複数のサンドボックスアカウントを作成できます。

用途例

• 日本のユーザー用テストアカウント
• 米国のユーザー用テストアカウント
• 異なる価格帯をテストするアカウント

アカウントの削除

不要になったサンドボックスアカウントは削除できます。

1. App Store Connect → ユーザーとアクセス → Sandbox
2. 削除したいアカウントを選択
3. 「削除」をクリック

パスワードのリセット

パスワードを忘れた場合は、App Store Connectから再設定できます。

1. Sandboxテスター一覧でアカウントを選択
2. 「パスワードを編集」
3. 新しいパスワードを入力して保存

💡 開発効率を上げるTips

Tip1: 専用のテストアカウント表を作成

複数のサンドボックスアカウントを管理する場合、スプレッドシートなどで管理すると便利です。

メールアドレス	パスワード	国/地域	用途
test-jp@example.com	Pass1234!	日本	通常検証
test-us@example.com	Pass1234!	アメリカ	米国価格検証
test-trial@example.com	Pass1234!	日本	トライアル検証

Tip2: Xcodeのログで購入フローを確認

Xcodeのコンソールログを確認することで、購入処理の詳細を把握できます。

// StoreKitのトランザクションログを出力
func paymentQueue(_ queue: SKPaymentQueue, updatedTransactions transactions: [SKPaymentTransaction]) {
    for transaction in transactions {
        print("Transaction state: \(transaction.transactionState.rawValue)")
        print("Product ID: \(transaction.payment.productIdentifier)")
    }
}

Tip3: TestFlightでのテスト

App Store Connectの「Sandbox」タブでサンドボックステスターを作成すると、TestFlightでもそのアカウントを使用できます。

これにより、より本番に近い環境でサブスクリプションをテストできます。

🎯 まとめ

今回は、iOSアプリ開発におけるサブスクリプション検証のためのサンドボックスアカウントの使い方を解説しました。

✅ ポイント

• サンドボックスアカウントは課金テスト専用のアカウント
• App Store Connectから簡単に作成できる
• 必ず利用規約への同意が必要（account.apple.comとicloud.com）
• テスト時は実機を使用し、購入時にサンドボックスアカウントでサインイン
• サンドボックス環境では期間が短縮される（1ヶ月→5分）
• レシート検証ではサンドボックス用URLを使用する

サブスクリプション機能の実装は、App Store審査でも重視されるポイントです。サンドボックスアカウントを使って徹底的にテストし、ユーザーに安心して使ってもらえるアプリを作りましょう。

📚 参考リンク

• Testing In-App Purchases - Apple Developer
• Sandbox testing - App Store Connect Help
• StoreKit - Apple Developer Documentation
• Not able login to simulator using the newly created sandbox account - Reddit

それでは、今回はこの辺で。