API コレクション

アプリ内購入

Swift ベースのインターフェースを使用して、Apple プラットフォーム全体でアプリ内のコンテンツとサービスを提供します。

概観

アプリ内購入 API を使用すると、あなたのアプリ内でデジタルコンテンツやサービスを購入する機会を顧客達に提供できます。顧客達はあなたのアプリ内で購入手続きを行い、App Store であなたの販売促進対象製品を見つけることが可能です。

StoreKit フレームワークは、あなたのアプリに代わって App Store に接続し、支払いを促し、安全に処理します。その後、フレームワークはあなたのアプリに通知し、アプリ内購入の取引を顧客のすべてのデバイスであなたのアプリを利用できるようにします。現在の購入を表す取引ごとに、あなたのアプリは購入された製品を配信します。購入の検証は、あなたのサーバー上で取引を検証するか、StoreKit の検証を利用することができます。

App Store はあなたのサーバーと通信することもできます。App Store は、App Store サーバー通知を通じて取引や自動更新サブスクリプションイベントをあなたのサーバーに通知し、App Store サーバー API を通じて同じ取引情報やその他の情報を提供します。

App Store 向けのアプリ開発ワークフロー全体におけるアプリ内購入の追加方法については、App Store Pathway をご覧ください。アプリ内課金とその機能 (その構成、テスト機能、製品のマーケティングなど) の概要については、シンプルで安全なアプリ内課金をご覧ください。サブスクリプションの概要 (サブスクリプショングループの作成、家族間共有など) については、自動更新サブスクリプションをご覧ください。

アプリ内購入の構成

アプリ内購入 API を使用するには、まずあなたのアプリで販売する製品を構成する必要があります。

開発の初期段階では、Xcode の StoreKit 構成ファイルで製品を構成し、App Store Connect に依存せずにあなたのコードをテストできます。詳しくは、Xcode で StoreKit テストを設定する (Setting up StoreKit Testing in Xcode) をご覧ください。

サンドボックステストと製品環境の準備ができたら、App Store Connect で製品を構成します。あなたのアプリの開発中に、製品を追加または削除したり、既存の製品を改良または再構成したりできます。詳しくは、App 内課金の設定をご覧ください。

複数のプラットフォームで動作するアプリやアプリ内課金を、1 回の購入で提供することもできます。ユニバーサル購入の詳細については、プラットフォームの追加をご覧ください。

あなたのアプリでストアをサポート

アプリ内購入 API は、Swift の機能（並行処理など）を活用してアプリ内購入ワークフローを簡素化し、SwiftUI を使用して StoreKit ビュー (StoreKit views) でストアを構築します。この API を使用することで、コンテンツやサブスクリプションへのアクセス管理、App Store 署名済みの取引情報の取得、すべてのアプリ内購入取引の履歴の取得などが可能になります。

WWDC21 関連セッション

セッション 10114: StoreKit 2 のご紹介

アプリ内購入 API は以下を提供します。

App Store で JSON Web Signature (JWS) 形式で署名された取引情報。

あなたのアプリ内で簡単に解析できる取引およびサブスクリプションのステータス情報。

顧客達向けのコンテンツやサービスのロックを解除するための権限の決定を簡素化する権限 API (currentEntitlements)。

WWDC22 関連セッション

セッション 110404: アプリ内購入のプロアクティブな復元を実装する

あなたのアプリでストアをサポートするには、以下の機能を実装して下さい。

取引リスナー、updates を使用して取引状態の変化を注視し、あなたのアプリの実行中に最新のサービスとコンテンツを提供します。

StoreKit ビュー (StoreKit views) を使用してあなたの製品を販売したり、products(for:) を使用して App Store から製品を表示するよう要求し、purchase(options:) を使用して購入を有効にしたりできます。購入結果である Product.PurchaseResult に基づいて、購入済みのコンテンツとサービスのロックを解除できます。

取引シーケンス all を使用して、いつでも顧客の購入履歴を反復処理し、購入済みのコンテンツとサービスのロックを解除できます。

必要に応じて、API からあなたが受信した署名済み取引と署名済みサブスクリプションのステータス情報を検証します。