Configure iOS サンドボックス テスト

iOS上のインアプリ購入テストには、App Store Connectとテストデバイスの設定が適切に構成されている必要があります。このガイドでは、サンドボックステストに必要なすべての内容をカバーしています。

前提条件

• Apple Developer Program会員資格の有効期限が年次更新される
• 契約: 銀行と税務情報の入力が完了した「有料アプリケーション契約」に署名
• Xcode Project: 正しいバンドル識別子と機能性が設定されている

Note

銀行と税務情報の設定承認には数時間から数日かかる可能性があります。テストの前に十分に準備してください。

セットアッププロセス

1. 有料アプリケーション契約に署名

   App Store Connectに移動し、 合意、税金、銀行 と完了する

   • Appleのアプリケーション利用規約に署名する
   • 銀行情報を追加する
   • 税金の書類を完了する

   Appleが情報を承認するのを待つ (24-48時間かかることがある)。

2. サンドボックステストユーザーを作成する

   App Store Connectに移動し、 Users and Access > Sandbox Testers.

   新しいサンドボックステストユーザーを作成するボタンをクリックする + 重要な注意事項あり

   重要な注意事項あり: Apple IDに紐づいていないメールアドレスを使用してください。メールアリセを使用できます。

   • Gmail: youremail+test@gmail.com
   • iCloud: youremail+test@icloud.com

   

3. テストデバイスを設定(iOS 12+)

   iOS 12以降では、iTunesアカウントからサインアウトする必要がなくなりました。購入テストを行うために。

   iOSデバイス上で:

   1. 開く 設定
   2. タップ App Store
   3. 下部までスクロール
   4. タップ サンドボックスアカウント
   5. サンドボックステストアカウントでサインインしてください

   ヒント

   iTunesアカウントからサインアウトする古い方法よりもはるかに便利です!

4. Xcodeプロジェクトを設定

   Xcodeプロジェクトには次のものが必要です

   バンドル識別子

   • 開発者センターの識別子と一致する必要があります
   • App Store Connectの識別子と一致する必要があります

   インアプリ購入機能

   1. Xcodeでプロジェクトを選択してください
   2. Go to Signing & Capabilities
   3. をクリック Capability
   4. を追加 In-App Purchase

5. In-App Purchaseの製品を作成

   App Store Connectでアプリを選択し、インアプリ購入製品を作成してください（サブスクリプション、消耗品など）。

   製品は、サンドボックステストのために少なくとも「提出準備完了」状態でなければなりません。

6. 実装をテストしてください

   テストデバイスでアプリをビルドして実行してください。購入を試みると、次のようになります：

   [Environment: Sandbox]

   実験環境にいることを確認します。実際の金銭はかかりません。

重要な注意事項

実験環境の特徴

• 実際の料金なし実験モードではすべての購入が無料です
• 加速されたサブスクリプションサブスクリプションの期間が短縮され、テストが速くなります
  • 1週間のサブスクリプション = 3分
  • 1か月のサブスクリプション = 5分
  • 2 か月のサブスクリプション = 10 分
  • 3 か月のサブスクリプション = 15 分
  • 6 か月のサブスクリプション = 30 分
  • 1 年のサブスクリプション = 1 時間
• 自動更新制限: サンドボックス内でサブスクリプションが自動更新される最大回数は 6 回
• 即時キャンセル: キャンセルされたサブスクリプションは即時有効

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

• テストアカウントはテストデバイスのみで使用する
• テストデバイスとは
• Don’t use personal Apple ID for sandbox testing
• Test accounts can purchase any product regardless of region

Using Sandbox Testing

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

const { isBillingSupported } = await NativePurchases.isBillingSupported();
if (!isBillingSupported) {
  throw new Error('StoreKit not supported on this device');
}

// Fetch products (automatically uses sandbox when available)
const { products } = await NativePurchases.getProducts({
  productIdentifiers: ['premium_monthly'],
  productType: PURCHASE_TYPE.SUBS,
});

// Make test purchase
const transaction = await NativePurchases.purchaseProduct({
  productIdentifier: 'premium_monthly',
  productType: PURCHASE_TYPE.SUBS,
});

console.log('Test purchase successful!', transaction.transactionId);

Verification

When properly configured, you should observe:

1. Sandbox banner during purchase: “[Environment: Sandbox]”
2. Products load successfully
3. 購入が完了しました 実際の請求なし
4. 領収書の検証 正しく
5. 自動更新 (加速された更新速度) トラブルシューティング

セクション：トラブルシューティング

App Store Connect の bundle identifier が一致しているか確認してください

• 契約が署名され承認されているか確認してください
• 製品が少なくとも「提出可能」状態であることを確認してください
• 製品が読み込まれない場合：
• 製品を作成後2-3時間待ってください

iTunesストアに接続できない”:

• サンドボックスアカウントの設定が正しくされていることを確認してください
• デバイスがインターネットに接続されていることを確認してください
• サンドボックスアカウントからログアウトして再度ログインしてください
• アプリを再起動してください

購入が静かに失敗している:

• Xcodeコンソールでエラーメッセージを確認してください
• In-App Purchase機能が有効になっていることを確認してください
• Apple IDが実際のメールアドレスではないことを確認してください
• 新しいサンドボックステストアカウントを作成してください

受領証の検証エラー:

• __CAPGO_KEEP_0__のサンドボックス受領検証エンドポイントをテストで使用
• __CAPGO_KEEP_1__エンドポイント: https://buy.itunes.apple.com/verifyReceipt
• __CAPGO_KEEP_2__エンドポイント: https://sandbox.itunes.apple.com/verifyReceipt
• native-purchases プラグインは自動的にこの処理を実行します

サブスクリプション期間が間違っています:

• サンドボックスではサブスクリプションが加速されることを思い出してください
• 期待される期間については、上の変換表を参照してください
• サンドボックスではサブスクリプションが最大6回自動更新されます

「このApple IDはまだiTunes Storeで使用されていません」:

• 新しいサンドボックスアカウントの場合、通常のことです
• 購入を続行してアカウントを有効化してください
• 最初の使用時のみ発生します

ベスト プラクティス

1. 複数のテスト アカウントを作成する 異なるテスト シナリオ用
2. すべてのサブスクリプション期間をテストする 動作を確認する
3. キャンセルと再契約のフロー 受領確認の機能が正しく動作する
4. 受領確認の機能が正しく動作する 購入の復元機能
5. 機能をテストする 機能をテストする
6. サブスクリプションのアップグレード/ダウングレードを確認 動作
7. ネットワーク条件が悪い場合のテスト

生産用 vs. サンドボックス

機能	サンドボックス	生産用
実際の料金	いいえ	はい
サブスクリプション期間	高速化	通常
自動更新制限	6回	無制限
キャンセル効果	即時	期間終了
受領エンドポイント	サンドボックスURL	本番URL
テストアカウントのみ	Yes	No

追加リソース

詳細については 公式のApple StoreKitドキュメント サンドボックステストについて

サンドボックステストの設定から

Capgoを使用している場合 Capgoを使用している場合、 Capgoを使用している場合、ストアの承認と配布を計画するには、Capgoを接続する @capgo/native-purchases native capabilityの使用に@capgo/native-purchasesを使用します @capgo/capacitor-in-app-review @capgo/capacitor-in-app-reviewの実装詳細については Using @capgo/capacitor-in-app-review native capabilityの使用にUsing @capgo/capacitor-in-app-reviewを使用します @capgo/capacitor-native-market @capgo/capacitor-native-marketの実装詳細については Using @capgo/capacitor-native-market native capabilityの使用にUsing @capgo/capacitor-native-marketを使用します