必須テストとチェックリスト
高品質なユーザーエクスペリエンスを確保し、収益の損失を防ぐために、すべての統合は公開前にこのチェックリストに照らして検証する必要があります。これらのテストは、ローカライズ、支払い方法の多様性、アプリの中断などの重要なエッジケースを網羅しています。
必須 QA チェックリスト
テストシナリオ | 期待される動作 |
|---|---|
1. 価格のローカライズ | ショップの価格が Aptoide Wallet アプリで設定された通貨と一致する。 |
2. 支払いの成功 | 購入が Sandbox、クレジットカード、外部決済を介して正常に完了する。 |
3. ユーザーによるキャンセル | アプリが「戻る」または「キャンセル」操作をクラッシュせずに適切に処理する。 |
4. 保留中の購入 | 中断された購入が、アプリの再起動後に正しく再開され消費される。 |
5. フルフィルメントフロー | アプリが 5 ステップのライフサイクルを厳密に従う。 （開始 → 結果 → 検証 → 提供 → 消費） |
詳細解説: 優先度の高いテスト
1. 価格のローカライズ
SDK は、ユーザーの Aptoide アカウント設定に基づいて通貨を自動的に取得します。
- テスト方法: Aptoide Wallet アプリを開き、希望の通貨を変更してから、ご自身のアプリに戻ります。
- 検証:
QueryProductDetailsが返す価格文字列が、UI に正しく表示されることを確認します。
2. 実際の支払いの検証（CC および外部決済）
クレジットカードや外部決済（GooglePay、AmazonPay など）のテストには、実際の取引が伴います。
- 返金ポリシー: これらのテストを完了したら、当社のサポートチームにお問い合わせください。QA 活動に対して課金されないよう、これらの取引を返金いたします。
- サポート: リアルタイムでこれらのフローの検証を支援するため、テストセッションに参加することが可能です。
3. ユーザーによるキャンセル
ユーザーが支払いオーバーレイを起動したものの購入しないと決めた場合、アプリがキャンセルコールバックを受け取り、「読み込み中」のループやクラッシュなしにユーザーを前の状態に戻すことを確認してください。
4. 保留中の購入の処理（重要）
保留中の購入は、取引が承認されたものの、SDK が結果を返す前にアプリが閉じられた場合に発生します。
⚠️ リスク: 購入が 48 時間以内に消費されない場合、Aptoide は自動的にユーザーへ返金します。
- シミュレーション方法: 支払いを開始し、「支払う」をクリックした直後に、ゲームを強制終了します。
- 検証: アプリを再起動します。初期化ロジックは、SDK の
queryPurchasesAsyncメソッドを使用して既存の購入をクエリし、アイテムが提供されたら Consume 呼び出しをトリガーする必要があります。 - モニタリング: 当社の Broker API を使用して、パッケージ名に関連付けられた保留中の取引を確認します。
5. 標準的な購入フロー
すべての取引について、コードロジックが次の順序に従っていることを確認してください。
- 購入の開始: アプリが SDK を呼び出してフローを開始します。
- 結果の受信: アプリが SDK の成功/失敗コールバックをリッスンします。
- 検証: バックエンドが購入トークンを検証します（サーバー間）。
- 提供: デジタルアイテムがユーザーのアカウントに付与されます。
- 消費: アプリ/サーバーが、アイテムが提供されたことを Aptoide に通知します。（このステップを省略しないでください！）
テストに関するヘルプが必要ですか？
解決できない問題が発生した場合は、問題の解決方法を案内する Connectoide サポートエージェントをご覧ください。これは Aptoide Connect アカウントの右上隅にあります。Billing SDK Log Analyzer や Billing SDK Transaction Analyzer を含む、利用可能なすべてのサポートツールの概要については、サポートツール ページを参照してください。
