Flutterの買い切り課金をテストする：購入・保留・復元の確認ガイド

購入ボタンを押して、Pro機能が使えるようになった。ここまで動くと、課金実装は完成したように感じます。でも、「支払いの途中でアプリを閉じたら？」「再インストールしたら？」という操作は、別に試しておきたいところです。

この記事では、Flutterの買い切り課金を購入成功・支払い保留・購入の復元の3場面に分けて点検します。機能を一度の購入で解除する、非消耗型の商品が対象です。

テスト前に、アカウントと環境を確認する

用意するのは、テスト用アプリ、購入前の状態を用意できるストアアカウント、操作結果を残すメモです。最初にOS・アプリ・in_app_purchaseのバージョンを記録しておくと、後から条件を再現しやすくなります。

iOSではAppleのテスト環境を使います。Androidのテスト用決済をそのまま再現することはできないため、ストアごとに結果を分けて記録してください。

3つの場面を、操作と結果で確かめる

CASE 01と02では、それぞれ未購入の状態を用意します。購入済みの同じ商品をそのまま再購入するテストにはしません。CASE 03は、CASE 01で購入したアカウントを使って試せます。

Google Playは、承認・拒否・遅延する支払いを試す方法を公開しています。決済選択肢の表示名や設定は、公式の保留テスト手順で確認できます。

「購入済み」は、端末内のフラグだけで決めない

再インストール後は、端末内の保存状態だけでは過去の購入を判断できないことがあります。復元では、購入情報を受け取り、正当性を検証してから機能を使えるようにする流れを確認します。in_app_purchaseの復元処理

Google Playは、機能の利用権を付与する前の購入検証を推奨しています。バックエンドを含め、どこで検証するかを決めておきましょう。購入検証に関する公式資料

また、completePurchaseは、購入の検証と機能の提供後に行う完了処理です。保留を購入成功と混同せず、pendingCompletePurchaseの確認を含めた処理を点検します。復元して機能を使えたことと、ストア側への必要な完了通知まで終えたことを分けて確認してください。購入完了処理の説明

結果を残すためのチェック表

表をコピーし、アプリの版・OS・確認日と一緒に記録できます。上の3ケースに加え、キャンセル・返金後の扱いも、公開前の確認に含めてください。

購入・保留・復元のどこで結果が食い違うか分かれば、実装の確認箇所も絞れます。最初から全部を追うのが難しければ、まずは「支払いを保留にしたまま再起動する」ところから試してみてください。