• 2025/12/8
• 4分

【Flutter/iOS】アプリ内課金の実装方法！in_app_purchase + StoreKit

＼ アプリをリリースしました ／

友達や家族の誕生日をメモ！通知も届く-みんなの誕生日-

posted withアプリーチ

• Android Studio：Narwhal Feature Drop
• Xcode：26.0.1
• iOS：26
• Flutter：3.38.3
• Dart：3.10.1
• in_app_purchase：3.2.3
• macOS(M1)：Tahoe 26.0.1

iOSのアプリ内課金

iOSアプリでアプリ内課金を実装する大まかな流れは以下の通りになります。Flutterで実装する場合でも以下の流れは必要になるので先に対応しておいてください。

大まかな実装の流れ

1. 有料App契約(App Store Connect)
2. 課金アイテムの設定(App Store Connect)
3. Capabilitiesの追加(Xcode)
4. 課金処理の実装(本記事)

詳細な設定手順などは以下の記事を参考にしてください。

またiOSアプリではアプリ内課金で購入できるアイテムとして以下の4種類があります。今回は広告削除などを想定して「非消耗型」の実装で進めてみたいと思います。

in_app_purchaseパッケージ

Flutterでアプリ内課金を実装する場合はin_app_purchaseパッケージを使用します。in_app_purchaseはiOS / Androidでのアプリ内課金機能をラップしてFlutterで使えるようにしてくれているパッケージになります。

インストールコマンド

 $ flutter pub add in_app_purchase

pubspec.yamlの中身

pubspec.yaml
dependencies:
  in_app_purchase: ^3.2.3

動作確認用のテスト環境を整える

アプリ内課金のテスト環境は.storekitファイルを用意することで簡単に構築することが可能です。設定方法は以下の記事で紹介しているので参考にしてください。

作業としては.storekitファイルを作成してスキームに設定するだけです。私はAndroid StudioでFlutterアプリを開発しておりそこからiOSシミュレーターをビルドした時に何故かアイテムが取得できませんでした。ですがXcode(Runner)から起動してビルドしたら無事アイテムを取得することができました。そのあとにAndroid Studioでビルドするとこちらでも正常に取得できるようになっていたので一度Xcode経由でビルドする必要があるようです。

実装の手順

1. アイテム情報を取得する：queryProductDetails
2. 購入処理を開始する：buyConsumable / buyNonConsumable
3. 購入ストリームの観測：purchaseStream
4. 復元処理の実装

1.アイテム情報を取得する：queryProductDetails

課金アイテムを取得するにはqueryProductDetailsメソッドを使用します。引数には取得対象となる課金アイテムIDを渡します。レスポンスはProductDetailsResponse型で取得できます。

final Set<String> _productIds = { `com.test.removeAds` };  
final _iap = InAppPurchase.instance;

final response = await _iap.queryProductDetails(_productIds);
// 取得に失敗したIDが格納される
print('notFound: ${response.notFoundIDs}');
// 取得に成功したアイテム情報が格納される
print('products: ${response.productDetails}');

ProductDetailsResponse型のnotFoundIDsに 取得に失敗したIDが格納され、productDetailsに取得に成功したアイテム情報が格納されます。List<ProductDetails>型で取得できるのでこれを使用して購入処理や実際にUIに金額などを表示させます。

ProductDetailsのプロパティ

2.購入処理を開始する：buyConsumable / buyNonConsumable

課金アイテムを購入するにはbuyNonConsumableメソッドを使用します。購入メソッドを呼び出すとOS標準のストアの購入シートが表示され決済フローを開始されます。

Future<void> buy(ProductDetails product) async {
  final PurchaseParam param = PurchaseParam(productDetails: product);
  await InAppPurchase.instance.buyNonConsumable(purchaseParam: param);
}

購入するアイテムはPurchaseParam型でラップして渡します。

今回は非消耗型なのでbuyNonConsumableですが、消耗型であればbuyConsumableを使用する必要がありアイテムによって呼び出すメソッドが異なってくるので注意してください。またbuyConsumableを使用する際はautoConsume: trueの設定をしておかないと正しく動作しないことがあるので注意してください。

await InAppPurchase.instance.buyConsumable(
  purchaseParam: PurchaseParam(productDetails: product),
  autoConsume: true, 
);

3.購入ストリームの観測：purchaseStream

購入処理の開始後には処理中・成功・失敗などのステータスが変化します。in_app_purchaseではストリームとして提供されておりpurchaseStreamから取得することができます。引数にはステータス更新周りのコールバック・完了処理・エラー処理を渡すことができます。トランザクションが無事完了したら明示的にcompletePurchaseを呼び出して処理は完了です。

/// 購入ストリームの監視開始
final purchaseUpdated = _iap.purchaseStream;
_subscription = purchaseUpdated.listen(
  _onPurchaseUpdate,
  onDone: () => _subscription?.cancel(),
  onError: (error) {
    logger('purchaseStream Error: $error');
  },
);

/// 購入更新コールバック
void _onPurchaseUpdate(List<PurchaseDetails> purchaseDetailsList) {
  for (final purchaseDetails in purchaseDetailsList) {
    switch (purchaseDetails.status) {
      case PurchaseStatus.pending:
        logger('購入処理中...');
        break;

      case PurchaseStatus.purchased:
        logger('購入成功！');
        // 購入成功処理
        _deliverProduct(purchaseDetails);
        break;

      case PurchaseStatus.error:
        logger('購入エラー: ${purchaseDetails.error}');
        break;

      case PurchaseStatus.restored:
        logger('購入復元！');
         // 復元成功処理
        _deliverProduct(purchaseDetails);
        break;

      default:
        break;
    }

    // 完了処理
    if (purchaseDetails.pendingCompletePurchase) {
      _iap.completePurchase(purchaseDetails);
    }
  }
}

購入に成功したらユーザーに対してアイテムの付与等をしてあげればOKです。

4.復元処理の実装

アプリ内課金の実装をする際には「復元処理の実装」が必須になります。これを実装しないとリジェクトされてしまうので注意してください。復元処理は簡単でrestorePurchasesを実行するだけです。これで再度観測していたストリームに復元成功ステータスが流れるのでハンドリングしてあげてください。

/// 購入復元処理
Future<void> _restore() async {
  await InAppPurchase.instance.restorePurchases();
}

まだまだ勉強中ですので間違っている点や至らぬ点がありましたら教えていただけると助かります。

ご覧いただきありがとうございました。