Billing API について
Billing API オブジェクトの連携方法を理解します。
サブスクリプションは請求書と Payment Intents を自動的に作成します。サブスクリプションには、以下のパーツが含まれています。
API オブジェクトの定義
リソース | 定義 |
---|---|
Customer (顧客) | サブスクリプションを購入する顧客を表します。サブスクリプションに関連付けられた Customer オブジェクトを使用して、継続支払いを作成して追跡し、顧客が登録する商品を管理します。 |
Entitlement (エンタイトルメント) | 顧客が登録したサービス商品に含まれる機能への顧客のアクセスを表します。顧客の商品の継続購入のサブスクリプションを作成すると、その商品に関連付けられた機能ごとに、有効な権利が自動的に作成されます。顧客がサービスにアクセスするときに、その有効な資格を使用して、サブスクリプションに含まれる機能を有効にします。 |
Feature (機能) | 顧客がサービス商品に登録すると利用できる機能や機能を表します。ProductFeatures を作成することで、商品に機能を含めることができます。 |
Invoice (請求書) | 顧客が支払うべき金額の明細書であり、下書きから支払い済み、またはその他の方法で確定された支払いステータスを追跡します。サブスクリプションでは請求書が自動的に生成されます。 |
PaymentIntent | 動的な支払いフローを構築する方法です。Payment Intent は、顧客の決済フローのライフサイクルを追跡し、規制で必須とされる同意書、Radar のカスタムの不正利用ルール、またはリダイレクトベースの支払い方法によって要求されたときに、追加の認証ステップを開始します。Payment Intent は、請求書によって自動的に作成されます。 |
PaymentMethod | 顧客が商品に対する支払いに使用する支払い方法。たとえば、クレジットカードを Customer オブジェクトに保存して、その顧客の継続支払いに使用することができます。通常、Payment Intents API または Setup Intents API とともに使用されます。 |
Price (価格) | 商品の単価、通貨、請求期間を定義します。 |
Product (商品) | お客様のビジネスが販売する商品またはサービス。サービス商品には 1 つ以上の機能を含めることができます。 |
ProductFeature | 1 つの商品に 1 つの機能が含まれることを表します。各商品は、含まれる各機能の ProductFeature に関連付けられ、各機能は、それを含む各商品の ProductFeature に関連付けられます。 |
Subscription (サブスクリプション) | 顧客の商品の継続的な購入を表します。サブスクリプションを使用して、支払いを回収し、商品の繰り返し提供や継続的なアクセスを提供します。 |
商品、機能、資格がどのように連携するかを示す例をここに示します。基本機能を備えた標準製品と、拡張機能を追加した高度な製品の 2 つの段階を提供するサブスクリプションサービスを設定したいと考えています。
basic_
とfeatures extended_
の 2 つの機能を作成します。features standard_
とproduct advanced_
の 2 つの商品を作成します。product - 標準商品の場合、
basic_
をfeatures standard_
に関連付ける ProductFeature を 1 つ作成します。product - 高度な商品の場合、2 つの ProductFeatures を作成します。1 つは
basic_
をfeatures advanced_
に関連付け、もう 1 つはproduct extended_
をfeatures advanced_
に関連付けます。product
顧客の first_
は、標準商品に登録します。サブスクリプションを作成すると、Stripe は、first_
を basic_
に関連付けるエンタイトルメントを自動的に作成します。
別の顧客no second_
は高度な商品に登録します。 サブスクリプションを作成すると、Stripe は自動的に 2 つのエンタイトルメントを作成します。1 つは second_
を basic_
に関連付け、もう 1 つは second_
を extended_
に関連付けます。
You can determine which features to provision for a customer by retrieving their active entitlements or listening to the Active Entitlement Summary event. You don’t have to retrieve their subscriptions, products, and features.