# Billing API について Billing API オブジェクトの連携方法を理解します。 [Checkout Sessions を使用して Subscriptions を作成することをお勧めします](https://docs.stripe.com/billing/quickstart.md)。Checkout Session では、顧客が決済の詳細を入力する決済ページを表示します。その後、Stripe は以下で説明する Billing API オブジェクトを使用して顧客を作成し、サブスクリプションを有効にし、決済を処理します。 *サブスクリプション* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis)を作成すると、Stripe は各請求サイクルで *`Invoice`* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) オブジェクトを自動的に生成します。各 `Invoice` は、顧客の保存された決済手段から決済を回収する *`PaymentIntent`* (API object that represents your intent to collect payment from a customer, tracking charge attempts and payment state changes throughout the process) オブジェクトを自動的に作成します。サブスクリプションを作成すると、Stripe が残りの請求ライフサイクルを管理します。 サブスクリプションには以下が含まれます。 - 販売対象をモデル化する*商品* (Products represent what your business sells—whether that's a good or a service)。 - 請求する期間と金額を決定する*価格* (Prices define how much and how often to charge for products. This includes how much the product costs, what currency to use, and the interval if the price is for subscriptions)。 - 各継続課金に使用する *決済手段* (PaymentMethods represent your customer's payment instruments, used with the Payment Intents or Setup Intents APIs) を格納する顧客を表すオブジェクト。顧客のモデル化方法に応じて、[顧客設定アカウント](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer-applied)または[顧客](https://docs.stripe.com/api/customers.md)のいずれかになります。 > #### Accounts v2 API を使用した顧客の表現 > > Accounts v2 API では、Connect ユーザーには一般提供され、その他の Stripe ユーザーには公開プレビューで提供されます。Accounts v2 プレビューの一部である場合は、コードで[プレビューバージョン](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning)を指定する必要があります。 > > Accounts v2 プレビューへのアクセスをリクエストするには、 > > ほとんどのユースケースでは、[Customer](https://docs.stripe.com/api/customers.md) オブジェクトを使用するのではなく、[顧客を顧客設定済みの Account オブジェクトとしてモデル化する](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md)ことをお勧めします。 #### Accounts v2 一般的な Billing オブジェクトとその関係を示した図 (See full diagram at https://docs.stripe.com/billing/billing-apis) #### Customer v1 一般的な Billing オブジェクトとその関係を示した図 (See full diagram at https://docs.stripe.com/billing/billing-apis) ## API オブジェクトの定義 | リソース | 定義 | | ------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [顧客として設定されたアカウント](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer) | サブスクリプションを購入する Accounts v2 API の顧客を表します。`Account` オブジェクトを顧客として設定し、それをサブスクリプションに関連付けて、継続課金の作成と追跡、サブスクリプション登録している商品の管理を行います。詳細については、[Use Accounts as customers ガイド](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md)を参照してください。 | | [Customer (顧客)](https://docs.stripe.com/api/customers.md) | サブスクリプションを購入する Customers API の顧客を表します。サブスクリプションに関連付けられた `Customer` オブジェクトを使用して、継続課金の作成と追跡、登録している商品の管理を行います。 | | [Entitlement (エンタイトルメント)](https://docs.stripe.com/api/entitlements/active-entitlement.md) | 顧客が登録したサービス商品に含まれる機能への顧客のアクセスを表します。顧客の商品の継続購入のサブスクリプションを作成すると、その商品に関連付けられた機能ごとに、有効な権利が自動的に作成されます。顧客がサービスにアクセスするときに、その有効な資格を使用して、サブスクリプションに含まれる機能を有効にします。 | | [Feature (機能)](https://docs.stripe.com/api/entitlements/feature.md) | 顧客がサービス商品に登録すると利用できる機能や機能を表します。ProductFeatures を作成することで、商品に機能を含めることができます。 | | [Invoice (請求書)](https://docs.stripe.com/api/invoices.md) | 顧客が支払うべき金額の明細書であり、下書きから支払い済み、またはその他の方法で確定された支払いステータスを追跡します。サブスクリプションでは請求書が自動的に生成されます。 | | [PaymentIntent](https://docs.stripe.com/api/payment_intents.md) | 動的な支払いフローを構築する方法です。Payment Intent は、顧客の決済フローのライフサイクルを追跡し、規制で必須とされる同意書、Radar のカスタムの不正利用ルール、またはリダイレクトベースの支払い方法によって要求されたときに、追加の認証ステップを開始します。Payment Intent は、請求書によって自動的に作成されます。 | | [PaymentMethod](https://docs.stripe.com/api/payment_methods.md) | 顧客が商品の支払いに使用する決済手段。たとえば、顧客が設定した `Account` または `Customer` オブジェクトにクレジットカードを保存して、その顧客の継続課金に使用することができます。通常、Payment Intents API または Setup Intents API とともに使用されます。 | | [Price (価格)](https://docs.stripe.com/api/prices.md) | 商品の単価、通貨、請求期間を定義します。 | | [Product (商品)](https://docs.stripe.com/api/products.md) | お客様のビジネスが販売する商品またはサービス。サービス商品には 1 つ以上の機能を含めることができます。 | | [ProductFeature](https://docs.stripe.com/api/product-feature.md) | 1 つの商品に 1 つの機能が含まれることを表します。各商品は、含まれる各機能の ProductFeature に関連付けられ、各機能は、それを含む各商品の ProductFeature に関連付けられます。 | | [Subscription (サブスクリプション)](https://docs.stripe.com/api/subscriptions.md) | 顧客の商品の継続的な購入を表します。サブスクリプションを使用して、支払いを回収し、商品の繰り返し提供や継続的なアクセスを提供します。 | 製品、機能、利用権がどのように連携するかの例をご紹介します。例えば、基本機能を提供する標準プランと、拡張機能を追加した上位プランの 2 つのプランを持つ定期サービスを設定するとします。 1. `basic_features` と `extended_features` の 2 つの機能を作成します。 1. `standard_product` と `advanced_product` の 2 つの商品を作成します。 1. 標準商品の場合、`basic_features` を `standard_product` に関連付ける ProductFeature を 1 つ作成します。 1. 高度な商品の場合、2 つの ProductFeatures を作成します。1 つは `basic_features` を `advanced_product` に関連付け、もう 1 つは `extended_features` を `advanced_product` に関連付けます。 顧客の `first_customer` は、標準商品に登録します。サブスクリプションを作成すると、Stripe は、`first_customer` を `basic_features` に関連付けるエンタイトルメントを自動的に作成します。 別の顧客no　`second_customer` は高度な商品に登録します。 サブスクリプションを作成すると、Stripe は自動的に 2 つのエンタイトルメントを作成します。1 つは `second_customer` を `basic_features` に関連付け、もう 1 つは `second_customer` を `extended_features` に関連付けます。 [有効なエンタイトルメントを取得するか、有効なエンタイトルメントのサマリーイベントをリッスンする](https://docs.stripe.com/billing/entitlements.md#entitlements)ことで、顧客に提供する機能を決定できます。顧客のサブスクリプション、商品、機能を取得する必要はありません。