Stripe Billing でサブスクリプションを作成する

プラットフォームを構築する場合、連結アカウントの顧客に対するサブスクリプションを作成し、オプションで支払いごとにプラットフォームに対する手数料を回収することができます。

この例では、顧客がお気に入りの著者に登録し、月額手数料を支払って各著者のプレミアムブログ投稿を受信できるオンライン出版プラットフォームを構築します。

はじめに

顧客または連結アカウントのサブスクリプションを作成する前に、以下を実行する必要があります。

1. プラットフォームで資金を受け取る個人ごとに連結アカウントを作成します。オンライン出版の例の連結アカウントは著者を表しています。
2. 料金体系モデルを作成します。この例では、定額料金の料金体系モデルを作成して顧客に定期的に手数料を請求しますが、ユーザー数ベースと使用量ベースの料金体系もサポートされています。
3. 連結アカウントに登録する個人ごとに指定の支払い方法を持つ顧客を作成します。オンライン出版の例では、著者に登録する読者ごとに顧客を作成します。

ダイレクト支払いとディスティネーション支払いのどちらかに決定する

ダイレクト支払いまたはディスティネーション支払いを使用して、顧客の支払いを連結アカウントとプラットフォームで分割できます。

ダイレクト支払いでは、プラットフォームの名前ではなく作成者の名前が明細書表記に表示されるため、顧客がプラットフォームの存在に気付くことはありません。オンライン出版の例では、読者は著者と直接やり取りします。

ダイレクト支払いは、Stripe ダッシュボードの全機能へのアクセスが可能な連結アカウント (Standard アカウントを含む) に推奨されます。

プラットフォームが Stripe の手数料、返金、チャージバックを負担するように設定する場合は、ディスティネーション支払いを使用します。オンライン出版の例の場合、顧客は特定の著者に直接登録するのではなく、出版プラットフォームに登録します。

デスティネーション支払いは、Express ダッシュボードにアクセスできる連結アカウント、または Stripe がホストするダッシュボードにアクセスできない連結アカウント (Express アカウントと Custom アカウントを含む) にお勧めします。

Connect の各種の支払いの詳細については、支払いタイプをご覧ください。

ダイレクト支払いを使用してサブスクリプションを作成する

Charges (支払い)で連結アカウントに関連付けられたサブスクリプションを作成するには、連結アカウントとして認証された状態でサブスクリプションを作成します。連結アカウントで、デフォルトの支払い方法とPrice (価格)を持つ顧客を定義するようにしてください。デフォルトの支払い方法を持たない顧客を指定するには、payment_behavior: "default_incomplete" を設定します。payment behavior の詳細をご確認ください。

latest_invoice.payment_intent を拡張して、支払いの確定に必要な Payment Element を含めます。詳細については、Payment Elements をご覧ください。

アプリケーションにサブスクリプションの登録と決済フローを実装する方法の詳細な例については、サブスクリプションの組み込みガイドをご覧ください。

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "expand[0]"="latest_invoice.payment_intent"

デスティネーション支払いを使用してサブスクリプションを作成する

Charge がプラットフォームに関連付けられ、連結アカウントへの送金を自動的に作成するサブスクリプションを作成するには、transfer_data[destination] 値として連結アカウント ID を指定して、Create subscription (サブスクリプションの作成) コールを実行します。

latest_invoice.payment_intent を拡張して、支払いの確定に必要な Payment Element を含めます。詳細については、Payment Elements をご覧ください。

必要に応じて application_fee_percent を指定できます。詳細については、手数料を回収するをご覧ください。

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "expand[0]"="latest_invoice.payment_intent" \
  -d "transfer_data[destination]"=
{{CONNECTED_ACCOUNT_ID}}

サブスクリプションを作成する前のその他のステップ

デスティネーション支払いを作成するには、プラットフォームアカウントで顧客と料金の両方を定義します。プラットフォーム上で連結アカウントが作成されている必要があります。また、顧客はプラットフォームアカウント内に存在する必要があります。デスティネーション支払いを使用する場合、プラットフォームは責任加盟店です。

Stripe Billing を使用すると、連結アカウントが関与することなく、顧客がプラットフォームと直接取引するサブスクリプションを作成できます。

この例では、顧客がレストランのオンデマンドデリバリーを注文できるマーケットプレイスを構築します。このマーケットプレイスは、デリバリー手数料が無料のプレミアム月次サブスクリプションを顧客に提供します。プレミアムオファリングに登録する顧客は、マーケットプレイスに直接支払い、特定のデリバリーサービスやレストランには登録しません。

はじめに

顧客のサブスクリプションを作成する前に、以下を実行する必要があります。

1. 料金体系モデルを作成します。この例では、定額料金の料金体系モデルを作成して顧客に定期的に手数料を請求しますが、ユーザー数ベースと使用量ベースの料金体系もサポートされています。
2. 請求先にするすべての顧客の顧客レコードを作成します。

マーケットプレイスから売上を受け取るユーザーごとに連結アカウントを作成することもできます。オンデマンドレストランのデリバリーの例の場合、連結アカウントはレストランまたはデリバリーサービスです。ただし、顧客がマーケットプレイスに直接登録する場合、このステップは必要ありません。

サブスクリプションを作成する

連結アカウントに売上を移動することなく、プラットフォームが売上を受け取るサブスクリプションを作成するには、サブスクリプションのガイドに従い、Stripe Billing でサブスクリプションを作成します。

支払いと送金別方式を作成する

プラットフォームが受け取る売上の一部を後で連結アカウントに手動で送金する場合は、支払いと送金別方式を使用して、1 つ以上の連結アカウントに売上を入金します。レストランのオンデマンデリバリーの例では、支払いと送金別方式を使用して、プレミアムデリバリーサービスに登録するように顧客を紹介した配達ドライバーやレストランにアフィリエイト手数料を入金することができます。

Stripe Billing を使用してサブスクリプションを作成し、プラットフォームの使用手数料を連結アカウントに請求することができます。

この例では、ジム管理ソフトウェアプラットフォームを構築して、ジムビジネスが月額手数料を支払ってクラスのスケジュール設定と予約を管理できるようにします。サブスクリプション手数料は、ジム利用者ではなく、ジムビジネスが支払います。

ジム管理ソフトウェアでは、ジム利用者が登録する各クラスのジム利用者とジムビジネスの間の 1 回限りの支払いも簡単にできます。月次サブスクリプションは、連結アカウントとプラットフォームの間で行われ、取引にジム利用者は関与しません。

上の図では、ジムビジネスが連結アカウントで、ジムの利用者が顧客です。

はじめに

顧客または連結アカウントのサブスクリプションを作成する前に、以下を実行する必要があります。

1. プラットフォームで売上を受け取るユーザーごとに連結アカウントを作成します。この例の場合、連結アカウントはジムビジネスです。
2. 料金体系モデルを作成します。この例では、定額料金の料金体系モデルを作成して顧客に定期的に手数料を請求しますが、ユーザー数ベースと使用量ベースの料金体系もサポートされています。
3. プラットフォームで、請求先の連結アカウントそれぞれのすべてに予定する支払い方法を指定して、顧客を作成します。ジム管理ソフトウェアの例では、ジムビジネスごとに顧客を作成します。

連結アカウントに相当する Customer オブジェクトを作成する

連結アカウントが Stripe を使用して顧客の支払いを処理している場合は、顧客ごとに Customer オブジェクトがすでに作成されている場合があります。

連結アカウントがプラットフォームに定期的な料金を支払うサブスクリプションを正常に作成するには、連結アカウントを表す別個の Customer オブジェクトを作成する必要があります。

ジムの例では、ジムビジネスが Stripe を使用して、ジム利用者の 1 回限りの支払いを処理します。Customer オブジェクトがすでにジム利用者ごとに作成されていますが、ジムビジネス自体を表す別の Customer オブジェクトを作成する必要があります。各法人を表す Customer を 1 つのみ作成してください。ビジネスのオーナー、マネージャー、オペレーターのそれぞれを表す Customer は作成しないでください。

連結アカウントのサブスクリプションを作成する

プラットフォームが連結アカウントから売上を受け取るサブスクリプションを作成するには、サブスクリプションのガイドに従い、Stripe Billing でサブスクリプションを作成します。取引に関与する Customer オブジェクトは、顧客ではなく、連結アカウントになります。ジムの例では、CUSTOMER_ID は、ジム利用者ではなく、ジムビジネスを表します。

Stripe creates event notifications when changes happen in your account, like when a recurring payment succeeds or when a payout fails. To receive these notifications and use them to automate your integration, set up a webhook endpoint. For example, you could provision access to your service when you receive the invoice.paid event.

Event notifications for Connect and subscriptions integrations

Here are the event notifications that Connect integrations typically use.

Here are the event notifications that subscriptions integrations typically use.

サブスクリプションを作成した後、顧客への表示や、本番環境のアクティビティーでの使用の前に、組み込みを十分にテストしてください。詳細については、Stripe Billing のテストをご覧ください。