アプリ内購入のテスト（サンドボックス環境）
Aptoide Connect でアプリ内購入（IAP）を含むアプリを配信するには、アプリに当社の課金ソリューションである Android Billing SDK を実装する必要があります。
実装後、アプリの IAP をテストして、統合が正しく機能しているかどうかを確認する必要があります。このため、IAP をテストできるサンドボックス環境を開発しました。
アプリの IAP をテストするには、以下を行う必要があります。
- Aptoide Wallet アプリをダウンロードする。
- （任意）テスト専用に使用する新しい Wallet アドレスを作成する。
- テスト用 Wallet アドレスを、デベロッパーコンソールのサンドボックスメニューに追加する。
- そのテスト用 Wallet アドレスを使用して、アプリで購入を行う。
Aptoide Wallet でサンドボックス環境を表示し、アプリのアプリ内購入をテストするには、Aptoide Connect でアプリの所有権を持っていることが必須です。
アプリをアカウントに追加し、アプリの所有権を正常に証明した後にのみ、サンドボックス環境（Aptoide Wallet の支払い方法として表示される）が表示されます。この方法については、こちらをクリックしてください。
（任意）テスト用 Wallet アドレスの作成
Aptoide Wallet アプリをダウンロードすると、すでにデフォルトのメイン Wallet アドレスが付与されています。ただし、ご希望であれば、テスト専用の Wallet アドレスを持つこともできます。
新しい Wallet アドレスを作成するには:
- Aptoide Wallet にアクセスする。
- 画面右上の歯車をクリックして、Wallet の設定メニューに移動する。
- 「Manage Wallet」をクリックする。
- 右側の「Manage Wallet」の横にある 3 点ドット > 「New Wallet」をクリックする。
- 新しい Wallet に名前を付ける > 「Submit」をクリックする。
サンドボックス環境の使用
サンドボックスメニューにアクセスするには、Aptoide Connect デベロッパーコンソールに移動し、Apps > Sandbox をクリックします。
このメニューでは、テスト専用の Wallet アドレスを追加したり、アカウントに追加されたすべての Wallet アドレスを表示したり、それらを管理したりできます。
テスト用の新しい Wallet アドレスを追加するには、「Add」をクリックし、サンドボックス環境でテスト専用に使用する Wallet アドレスを貼り付けて、「Add」をクリックします。
サンドボックスメニューの「Added」列は、Wallet アドレスが Aptoide Connect アカウントに追加された時期を示します。「Expiration」列は、Wallet アドレスが自動的に非アクティブに設定される時期を示します。最後に、「Active」列では、特定の Wallet アドレスがサンドボックス環境を使用できるかどうかを切り替えて変更できます。
Wallet アドレスがサンドボックスメニューに追加されると、サンドボックス環境で使用できるよう、トグルが「Active」に設定されます。30 日後、このトグルは自動的に切り替わり、テスト用 Wallet アドレスは「Inactive」に設定されます。
非アクティブになると、Wallet アドレスは通常の Wallet になり、サンドボックス環境で使用することはできなくなります。再度テストに使用するには、トグルを再び「Active」に変更する必要があります。
Wallet アドレスが自動的に非アクティブに設定される時期は、「Expiration」列の日付を確認することで把握できます。
または、アプリ送信フォームの使用中にサンドボックスメニューにアクセスすることもできます。
サンドボックス環境を使用してアプリのアプリ内購入をテストするには、ログイン確認を設定して有効にする必要があることにご注意ください。この方法については、こちらをクリックしてください。
アプリ内購入のテスト
Aptoide Connect で Wallet アドレスを追加した後、以下の手順に従って、アプリ内でアプリ内購入をテストできます。
- アプリで購入したいアイテムを選択する。
- 下にスクロールして、Sandbox オプションを選択し、購入を続行する。
購入が完了すると、購入が完了したことを示すポップアップメッセージが画面に表示されます。アプリ内購入が正常に完了したことを確認するには、Aptoide Connect コンソールの上部メニューバーにある Wallet にアクセスし、「Only display sandbox transactions」オプションにチェックを入れます。
そこで、サンドボックス環境で行われたトランザクションの一覧を表示し、たった今行った購入を確認できます。また、アプリでアイテムが受け取られたかどうかも確認してください。
購入を行うことができ、アイテムを正しく受け取り、エラーが発生しなければ、当社の課金ソリューションの統合は成功です。
サンドボックス固有の動作
サンドボックス環境は実際の課金システムを再現していますが、より迅速にテストできるよう、意図的にいくつかの相違点があります。
購入の承認および消費の時間制限
サンドボックス環境では、購入を承認または消費するための時間制限は、本番の課金システムで使用される 2 日間ではなく、5 分間です。
この時間内に購入が承認または消費されない場合、その購入は自動的に払い戻しされます。この短縮された制限により、アプリを公開する前に、失敗シナリオ（たとえば、承認されない購入が取り消される場合）を迅速にテストできます。
購入を承認および消費する方法については、Android Billing SDK の統合ガイドを参照してください。
サンドボックスでのサブスクリプション更新期間
アプリ内サブスクリプションは現在開発中であり、まもなくリリースされる予定です。以下の情報は今後提供されるサンドボックスでの動作について説明したものであり、リリース前に変更される可能性があります。
サンドボックス環境でサブスクリプションをテストする際は、更新を確認するために完全な課金サイクルを待つ必要がないよう、更新期間が短縮されます。当社は Google Play Billing – Test renewals と同じ値に従います。
| 本番のサブスクリプション期間 | サンドボックスでの更新期間 |
|---|---|
| 1 週間 | 5 分間 |
| 1 か月 | 5 分間 |
| 3 か月 | 10 分間 |
| 6 か月 | 15 分間 |
| 1 年 | 30 分間 |
サンドボックス環境では、サブスクリプションは最大 6 回更新された後、自動的にキャンセルされます。更新のタイミングは概算であるため、多少の変動が生じることがあります。
よくある質問
サンドボックスでテストする前に、何か準備しておく必要はありますか？
簡潔な回答: はい。まず、アプリ内購入とテスト用 Wallet を追加してください。
詳細: Android でテストする前に、上記のとおり、Aptoide Connect コンソールでアプリ内購入を追加し、サンドボックス環境にテスト用 Wallet アドレスを追加してください。その後にのみ、アプリからサンドボックス購入を完了できます。
サンドボックスでの購入が払い戻されたのはなぜですか？
簡潔な回答: 5 分以内に承認または消費されなかったためです。
詳細: 購入の承認および消費の時間制限を参照してください。サンドボックス環境では、購入を承認または消費するための時間は（本番システムの 2 日間ではなく）5 分間です。その時間内に行わないと、購入は自動的に払い戻されます。これは想定どおりの動作であり、承認されない購入のシナリオを迅速にテストできます。