サブスクリプションの仕組み
サブスクリプションでは、顧客は商品を利用するために継続的に支払いを行います。サブスクリプションの場合、以降も顧客に請求する必要があるため、1 回限りの購入よりも顧客について多くの情報を保持する必要があります。
サブスクリプションのオブジェクト
以下の主要な API リソースを使用して、サブスクリプションを構築および管理します。
リソース | 定義 |
---|---|
Product (商品) | ビジネスが提供する商品またはサービスを表します。 |
Price (価格) | 商品の請求額と請求頻度を定義します。商品コスト、使用通貨、および期間 (サブスクリプションの価格の場合) が含まれています。 |
Customer (顧客) | Stripe の Customer オブジェクトを使用することで、同一顧客に対する継続請求の実行と、複数の請求の追跡ができるようになります。サブスクリプションを作成すると、顧客 ID が Subscription オブジェクトに渡されます。 |
PaymentMethod (支払い方法) | サービスに対する顧客の支払い方法を表します。たとえば、クレジットカードを Customer オブジェクトに保存して継続的に使用することができます。通常、Payment Intents API または Setup Intents API とともに使用されます。 |
Subscription (サブスクリプション) | 顧客が登録しているプランに関連する商品の詳細を表します。サブスクリプションにより、定期的に顧客に請求できます。 |
Invoice (インボイス) | 顧客が支払う必要がある金額の明細書です。下書きから、支払い済みになるかその他の最終的な確定に至るまで、支払いのステータスを追跡します。サブスクリプションではインボイスが自動生成されますが、1 回限りのインボイスを手動で作成することもできます。 |
PaymentIntent (支払いインテント) | 動的な支払いフローを構築する方法です。Payment Intent は、顧客の決済フローのライフサイクルを追跡し、規制で必須とされる同意書、Radar のカスタムの不正使用ルール、またはリダイレクトベースの支払い方法によって要求されたときに、追加の認証ステップを開始します。Payment Intent は、インボイスによって自動的に作成されます。 |
組み込み例
このセクションでは、サブスクリプションのシステムを構築する方法を示す、GitHub の実装サンプルについて説明します。自社でシステムを構築する準備が整っている場合、Billing クイックスタートまたは実装ガイドをご覧ください。
ランディングページ
お客様のフロントエンドでは、最初にランディングページでメールアドレスが収集され、アプリケーションでは、ユーザー名や住所など、その他の顧客特有の情報を収集できます。登録ボタンがクリックされると、ランディングページで収集された情報がバックエンドに送信されます。このプロセスで新しい顧客が作成され、フロントエンドで料金体系ページが表示されます。
料金体系ページ
料金体系ページには、組み込みの初回設定時に作成した商品や価格に基づき、サブスクリプションオプションが表示されます。このため、顧客が登録するたびに新しい商品や価格を作成する必要はありません。料金体系ページにはお客様が作成した価格が表示され、顧客はその中から希望のオプションを選択します。GitHub の例では、顧客がオプションを選択すると、決済フォームが表示されます。
商品および価格についてご確認ください。
支払い
決済フォームで名前とカード情報が収集されます。Checkout を使用すると Stripe がオンラインでこのフォームを提供します。これは、支払いを収集し、PCI 準拠を維持するための主要機能の 1 つです。申し込む ボタンをクリックすると、以下が実行されます。
- 顧客 ID と価格 ID を使用して、新しいサブスクリプションが作成されます。
- 初回のサブスクリプションサイクルのインボイスが生成されます。
- 決済情報が収集され、インボイスに対する支払いが行われます。
- この決済手段をサブスクリプションのデフォルトの決済手段として設定します。これは後続の支払いのために必要です。
これを実装するには、以下のようにします。
- コードなし: コードを記述したくない場合は、決済フォームへのリンクを作成し、顧客と共有する方法をご確認ください。
- ローコード: Checkout を使用する場合は、Checkout セッションを作成するボタンをウェブサイトに追加する方法をご確認ください。
- カスタムコード: Elements を使用する場合、 Payment Element または Card Element を使用して支払いの詳細を収集し、サブスクリプションを有効化する方法をご確認ください。
プロビジョニング
エンタイトルメントを使用して、顧客へのプロダクト機能のアクセス権を付与または取り消すタイミングを決定します。
また、支払いが成功すると、顧客に商品を提供することができます。通常の場合、以下のアクションを実行することになります。
- サブスクリプションのステータスが
active
であることを確認します。 - 顧客が登録した商品や機能へのアクセスを顧客に付与します。
Webhook を使用して以下を行う方法をご確認ください。
サブスクリプションにおける支払いの仕組み
失敗した支払いの処理を簡略化し、支払いの試行前にサブスクリプションを作成するには、以下のようにします。
- サブスクリプションを作成するときに、payment_behavior=default_incomplete を渡します。これにより、サブスクリプションで支払いが必要になると、
incomplete
のステータスで作成されます。このように設定しない場合、サブスクリプションは即時にactive
になります。 - 最初のインボイスへの支払いを行うことで、未完成のサブスクリプションを有効化します。
- payment intent の ID をインボイスからユーザーインターフェイスに渡して支払い情報を収集し、payment intent を確定します。Elements、Android SDK、または iOS SDK を使用できます。
支払いステータス
決済プロセスは、決済手段や地理的な場所によって異なります。さらに最初の支払いが失敗することもあるため (例: 顧客が入力したカード番号の誤り、資金不足など)、さまざまな決済結果が生じる可能性があります。
PaymentIntent は、すべての支払いのライフサイクルを追跡します。サブスクリプションの支払い期日のたびに、インボイスと PaymentIntent が生成されます。PaymentIntent ID がインボイスに関連付けられ、この ID には Invoice および Subscription のオブジェクトからアクセスできます。PaymentIntent の状態は、インボイスとサブスクリプションの状態に影響します。以下は、支払い結果のそれぞれが各種のステータスにどのようにマッピングされるかを示しています。
支払い結果 | PaymentIntent ステータス | インボイスのステータス | サブスクリプションのステータス |
---|---|---|---|
成功 | succeeded | paid | active |
カードエラーによる失敗 | requires_payment_method | open | incomplete |
認証による失敗 | requires_action | open | incomplete |
以降のセクションでは、これらのステータスと、各ステータスに対するアクションを説明します。
支払いの成功
支払いに成功すると、PaymentIntent のステータスは succeeded
になり、サブスクリプションは active
になります。処理期間が長い決済手段では、サブスクリプションはすぐに有効になります。このような場合、支払いに成功するまで active
なサブスクリプションの PaymentIntent は processing
になる可能性があります。
これでサブスクリプションが有効になったため、商品へのアクセスを提供します。サブスクリプションのライフサイクルと商品提供時のベストプラクティスについての詳細はガイドをご覧ください。
レスポンス | サブスクリプション | PaymentIntent |
---|---|---|
| 有効 | succeeded |
支払い方法が必要
支払い拒否などのカードエラーが原因で決済が失敗した場合、PaymentIntent のステータスは requires_payment_method
で、サブスクリプションは incomplete
になります。
レスポンス | サブスクリプション | PaymentIntent |
---|---|---|
| incomplete | requires_payment_method |
これらのシナリオを解決するには、以下のステップに従います。
- 顧客に通知します。
- 新しい支払い情報を収集し、PaymentIntent を確定します。
- サブスクリプションでデフォルトの支払い方法を更新します。
サブスクリプションの支払い失敗を処理する方法は以下のとおりです。
アクションが必要
一部の支払い方法では、支払いプロセスを完了するために 3D セキュア (3DS) による顧客認証が必要です。Payment Intents API を使用する場合、顧客が支払いを認証する必要があるときの latest_invoice.payment_intent.status
の値は requires_action
です。3DS によって認証プロセスが完了されます。支払い方法に認証が必要かどうかは、Radar ルールとカード発行会社によって異なります。
ヨーロッパの規制では、多くの場合 3D セキュアが要求されます。 強力な顧客認証 (SCA) ガイドを参照して、このステータスの処理がお客様のビジネスにとって重要かどうかを判断してください。既存の Billing の組み込みがあり、このフローのサポートを別途ご希望の場合は、Billing の SCA 移行ガイドもご覧ください。
レスポンス | サブスクリプション | PaymentIntent |
---|---|---|
| incomplete | requires_action |
これらのシナリオを処理するには、以下のステップに従います。
- Webhook で
invoice.payment_action_required
イベントの通知を監視します。これは、認証が必要であることを示します。 - 認証が必要であることを顧客に通知します。
- Payment Intent の client secret を取得し、それを stripe.ConfirmCardPayment のコールに渡します。これにより、顧客に認証モーダルが表示され、支払いが試行されると、モーダルを閉じられてコンテキストがアプリケーションに戻されます。
- Webhook エンドポイントで
invoice.paid
イベントをモニタリングし、支払いが成功したことを確認します。ユーザーは、confirmCardPayment()
が完了する前にアプリケーションを離れることができます。支払いが成功したかどうかを確認することで、商品を正しく提供できます。
継続支払い
Stripe は、継続支払いを自動的に処理します。これには以下が含まれます。
- 新しい請求サイクルが始まると顧客に自動的に請求し、支払いの収集を試みます。
- 決済が失敗すると、Stripe は Smart Retries 機能を使用して再試行します。この機能では、カードが拒否された場合、ダッシュボードの設定に従って決済を自動的に再試行します。
回収の確率を上げるために、期限が過ぎた支払いに関して顧客に督促メールlを送信できます。3D セキュアが必要とされる支払いでは、Billing の設定を構成し、顧客がフローを完了できるように、ホストされたリンクを顧客に送信できます。
継続支払いの失敗を処理するカスタムの方法を構築する
失敗の管理に Stripe のツールを使用しない場合、独自に構築することができます。支払いが失敗、または支払いに顧客の認証が必要な場合、サブスクリプションの status
が past_due
に設定され、PaymentIntent ステータスは requires_payment_method
または requires_action
のいずれかに設定されます。
これらのシナリオを管理するには、Webhook を設定し、customer.subscription.updated イベントをリッスンして、サブスクリプションが past_due
状態になったときに通知を受けられるようにします。
{ "id": "sub_E8uXk63MAbZbto", "object": "subscription", ... "status": "past_due", "latest_invoice": "in_1EMLu1ClCIKljWvsfTjRFAxa" }
これらのサブスクリプションで決済を完了するには、別の決済手段を収集するため、顧客にアプリケーションに戻ってもらう必要があります。これには、メールまたはモバイルのプッシュ通知を使用できます。Stripe では、このケースを処理するために構築済みのリマインドメールを提供しています。これは、Billing の設定で設定できます。
顧客がアプリケーションに戻ったら、関連する PaymentIntent のステータスに基づいて、決済失敗フローまたは顧客アクションフローを使用します。決済が成功すると、サブスクリプションのステータスが active
、インボイスのステータスが paid
になります。
未払いのインボイスの処理
無料トライアルや従量課金を含むサブスクリプション、またはクーポンや顧客のクレジット残高が適用されたインボイスは、未払いになることがよくあります。これは、サブスクリプションの作成時に顧客にすぐに請求を行わないことが原因です。
顧客に対して最初のインボイスの請求を行わない場合でも、顧客のカードを認証してオーソリしておくと、金額を伴う最初の支払いの際に決済が成功する確率が高くなるため、将来のために役立ちます。この方法で行われた決済は、オフセッション支払いと呼ばれます。このようなシナリオに対応できるように、Stripe は SetupIntents を作成しました。
SetupIntents の使用
SetupIntents を使用して以下のことができます。
- 決済情報を収集します。
- 顧客のカードを認証して、後で免除を求めます。
- 請求せずに顧客のカードをオーソリします。
決済を認証すると、顧客はカードへの請求を許可できます。これは強力な顧客認証での要求事項であり、3DS はこの認証を完了するため方法として一般的です。決済手段情報を収集してオーソリすることにより、その決済手段への請求が確実に成功するようになります。
オフセッションのシナリオでは、SetupIntents によってゼロ以外の金額の初めての支払いを顧客に請求することができ、その際、認証のために 顧客を Web サイトやアプリに戻す必要はありません。この結果、顧客の負担が軽減します。
サブスクリプションの pending_setup_intent
フィールドは、サブスクリプションが終了しても自動的にキャンセルされません。customer.subscription.deleted
をリッスンし、必要に応じて手動でサブスクリプションの SetupIntent をキャンセルしてください。
初回の決済を必要としないサブスクリプションに対して、SetupIntent が自動的に作成されます。必要に応じ、この時点で認証とオーソリのプロセスも実行されます。認証とオーソリの両方が成功した場合、またはどちらも不要な場合は、アクションは不要で、subscription.pending_setup_intent
フィールドは null
となります。いずれかの手順が失敗した場合には、フロントエンドで SetupIntent を使用し、顧客がオンセッションの間に問題を解決することをお勧めします。次の 2 つのセクションでは、認証またはオーソリが失敗した場合の対応方法を詳しく説明します。
認証失敗の管理 Client-side
認証の失敗は、Stripe が顧客のカード発行会社との間で顧客を認証できない場合に発生します。この場合、SetupIntent の status
が requires_action
に設定されます。
このようなシナリオを解決するには、フロントエンドで confirmCardSetup を呼び出して、顧客が認証フローを手動で完了できるようにします。以下のコード例では、pending_setup_intent
を拡張してフローを完了しています。
const {pending_setup_intent} = subscription; if (pending_setup_intent) { const {client_secret, status} = subscription.pending_setup_intent; if (status === "requires_action") { const {setupIntent, error} = await stripe.confirmCardSetup(client_secret); if (error) { // Display error.message in your UI. } else { // The setup has succeeded. Display a success message. } } }
このフローが完了すると、必要に応じてオーソリが実行されます。オーソリが成功した場合、またはオーソリが不要な場合、完了時に pending_setup_intent
が null
に更新されます。
オーソリ失敗の管理 Client-side
カードが請求可能であることを Stripe が確認できない場合、支払いのオーソリが失敗します。この場合、SetupIntent の status
は、requires_payment_method
に設定されます。通常、当該カードを使用した後続の請求は失敗することになります。
このようなシナリオを解決するには、新しい決済手段を収集してから、顧客またはサブスクリプションのデフォルトの決済手段を更新します。以下のコード例では、pending_setup_intent
を拡張してフローを完了しています。
const {pending_setup_intent, latest_invoice} = subscription; if (pending_setup_intent) { const {client_secret, status} = subscription.pending_setup_intent; if (status === "requires_action") { const {setupIntent, error} = await stripe.confirmCardSetup(client_secret); if (error) { // Display error.message in your UI. } else { // The setup has succeeded. Display a success message. } } else if (status === "requires_payment_method") { // Collect new payment method } }
サブスクリプションのライフサイクル
推奨されるサブスクリプションフローは次のとおりです。
- サブスクリプションを作成します。サブスクリプションの
status
はincomplete
です (推奨されるフローに従った場合。payment_behavior
を指定せずにサブスクリプションを作成した場合、デフォルトのstatus
はactive
になります)。 - サブスクリプションのインボイスが作成されます。インボイスの
status
はopen
です。 - 顧客が最初のインボイスへの支払いを行います。
- 支払いが成功すると、以下のようになります。
- サブスクリプションの
status
がactive
に移行します - インボイスの
status
がpaid
に設定される - Stripe によって
invoice.paid
イベントの Webhook イベントが送信されます。
- サブスクリプションの
- 商品へのアクセスを提供します。以下のようにして、インボイスの支払いが行われたかどうかを確認できます。
- Webhook エンドポイントを設定して、
invoice.paid
イベントをリッスンする。 - サブスクリプションオブジェクトを手動で確認し、
subscription.status=active
を探します。自動請求または顧客による手動での支払いによってインボイスへの支払いが行われると、status
はactive
になります。
- Webhook エンドポイントを設定して、
支払いが不要なトライアルを提供する場合、status
を trialing
にすることもできます。トライアルが終わると、サブスクリプションは active
に移行し、サブスクライブする顧客への請求が開始されます。
サブスクリプションの支払い処理
payment_behavior
を default_incomplete に設定してサブスクリプションを作成すると、失敗した決済の処理を簡易化できます。これにより、ステータスが incomplete
のサブスクリプションが作成され、1 つのユーザーインターフェイスで決済情報の収集と確定をできるようになります。allow_incomplete
または error_if_incomplete
を使用すると、Stripe は直ちにインボイスの決済を試行します。決済が失敗した場合には、サブスクリプションのステータスが incomplete
に変化するか、作成が失敗します。
成功した支払い
顧客によるインボイスへの支払いが成功すると、サブスクリプションは active
に更新され、インボイスは paid
に更新されます。この時点で、商品へのアクセスを提供できます。
支払い期間
顧客は約 23 時間以内に支払いを成功させる必要があります。この間、サブスクリプションのステータスは incomplete
、インボイスは open
のままです。顧客がインボイスに対して支払いを行うと、サブスクリプションは active
に、インボイスは paid
に更新されます。支払いが行われない場合、サブスクリプションのステータスは incomplete_expired
に、インボイスは void
に更新されます。
この時間枠が設けられているのは、通常、顧客はサブスクリプションの初回の決済をオンセッション中に行うためです。顧客が 23 時間経過した後にアプリケーションに戻ってきた場合は、新しいサブスクリプションを作成します。
失敗した支払い
サブスクリプションのステータスは、自動決済が成功している限り active
のままとなります。自動決済が失敗すると、サブスクリプションが past_due
に更新され、Stripe はお客様のリトライルールに基づいて支払いを回収しようとします。支払いを回収できなかった場合、サブスクリプションのステータスを canceled
または unpaid
にすることも、past_due
のままにすることもできます。
未払いのサブスクリプション
支払いが行われないサブスクリプションの場合、最新のインボイスは open のままですが、支払いは試行されません。サブスクリプションではインボイスが請求サイクルごとに継続して生成され、ステータスは draft
のままになります。サブスクリプションを再度有効化するには、以下を実行する必要があります。
- 新しい決済情報を収集します。
- 下書きインボイスで auto advance を
true
にして自動収集を再開します。 - 未払いのインボイスを確定し、次にその支払いを行います。サブスクリプションのステータスを
active
に更新するには、期限が切れていない最新のインボイスを支払います。
デフォルト動作では、past_due
のサブスクリプションを unpaid
に設定するようになっています。これにより、サブスクリプションを再度アクティブにするためのオプションを最も多く得ることができます。
サブスクリプションをキャンセル
サブスクリプションをキャンセルすると、そのサブスクリプションの新しいインボイスの作成が無効になり、auto_advance
が false
に設定され、そのサブスクリプションのすべてのインボイスの自動回収が停止されます。また、そのサブスクリプションは削除されます。顧客が再びサブスクリプションを希望する場合、顧客から新しい決済情報を収集して新しいサブスクリプションを作成する必要があります。
サブスクリプションで生成されたインボイスの無効化
サブスクリプションが incomplete
で、生成された最初のインボイスを無効にした場合、そのサブスクリプションは incomplete_expired
に更新されます。有効なサブスクリプションの最新のインボイスを無効にし、そのインボイスが最初のものではない場合には、 各インボイスに以下のロジックが適用され (最新のものから順に)、以下の条件のいずれか 1 つが満たされるまで続行されます。
- インボイスが
paid
またはuncollectible
のステータスの場合は、サブスクリプションのステータスはactive
に設定されます。 - インボイスで collection_method が
charge_automatically
に設定されており、再試行の上限回数に達しているために Stripe がインボイスの督促を停止した場合には、そのサブスクリプションのステータスは、自動回収設定に基づいて、canceled
、unpaid
、またはpast_due
に設定されます。 - collection_method が
send_invoice
に設定され、インボイスの期限が過ぎている場合、そのサブスクリプションのステータスはpast_due
に設定されます。 - インボイスのステータスがこれらのいずれにも該当しない場合、次の最新のインボイスで同じステップが実行されます。
上記の条件を満たすインボイスがない場合には、サブスクリプションのステータスは active
に設定されます。
サブスクリプションステータス
ステータス | 説明 |
---|---|
trialing | サブスクリプションは現在トライアル期間中であり、顧客に商品を提供しても安全です。 最初の支払いが行われると、サブスクリプションは自動的に active に移行します。 |
active | サブスクリプションは良好な状態であり、直近の支払いは正常に行われました。 顧客に商品を提供しても安全です。 |
incomplete | サブスクリプションを有効にするには、23 時間以内に支払いを成功させる必要があります。あるいは、支払いで顧客の認証などのアクションが必要です。保留中の支払いがあるときも、サブスクリプションは incomplete になる場合があります。その場合、PaymentIntent のステータスは processing です。 |
incomplete_expired | サブスクリプションの初回の支払いが失敗し、サブスクリプションの作成から 23 時間以内に成功した支払いがありませんでした。これらのサブスクリプションは顧客に請求しません。このステータスは、サブスクリプションの有効化に失敗した顧客を追跡するために存在します。 |
past_due | latest finalized invoice に対する支払いは、失敗したか、実行されていないかのどちらかです。サブスクリプションは請求書の作成を継続します。サブスクリプションの設定によって、サブスクリプションの次の状態が決まります。すべての Smart Retries が試行された後でも請求書が未払いである場合、サブスクリプションが canceled 、unpaid に移行するか、past_due のままになるように設定できます。サブスクリプションを active に移行するには、期日前に最新の請求書を支払ってください。 |
canceled | サブスクリプションはキャンセルされています。キャンセルの際に未払いのすべてのインボイスの自動回収が無効化されます (auto_advance=false )。これは、それ以上更新ができない最終的なステータスです。 |
unpaid | 最新のインボイスは支払われていませんが、サブスクリプションはそのままで保持されます。最新のインボイスは未払いステータスのままになり、インボイスの生成は続行されますが、支払いの試行は行われません。支払いはすでに試行され past_due であったときに再試行されたため、サブスクリプションが unpaid の場合、商品へのアクセスを取り消す必要があります。サブスクリプションを active に移行するには、その期日前に最新のインボイスへの支払いを行います。 |
paused | サブスクリプションは、デフォルトの決済手段を指定されずにトライアル期間が終了し、trial_settings.end_behavior.missing_payment_method は pause に設定されます。サブスクリプションに対してインボイスは作成されなくなります。デフォルトの決済手段が顧客に関連付けられた後、サブスクリプションを再開できます。 |
サブスクリプションのイベント
サブスクリプションが作成または変更されるたびに、Events (イベント) がトリガーされます。一部のイベントはサブスクリプションが作成されるとただちに送信され、その他のイベントは通常の請求期間ごとに発生します。Webhook エンドポイントを使用してイベントをリッスンすることをお勧めします。
自社の構築済みのシステムでイベントが適切に処理されることを確認します。たとえば、支払いが失敗すると顧客にメールを送信したり、サブスクリプションがキャンセルされると顧客のアクセスを取り消したりすることができます。
以下の表には、サブスクリプションに関連する最も一般的なイベントと、該当する場合は、それらのイベントを処理するための推奨アクションが示されています。
customer.created | 顧客の作成に成功すると送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.created | サブスクリプションが作成されると送信されます。支払いを完了するために顧客の認証が必要な場合、または payment_behavior を default_incomplete に設定した場合、サブスクリプションの status が incomplete になります。詳細については、サブスクリプションの支払い処理をご覧ください。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.deleted | 顧客のサブスクリプションが終了すると送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.paused | サブスクリプションの status が paused に変わると送信されます。たとえば、決済手段が指定されずに無料トライアルが終了した場合に一時停止するようにサブスクリプションが設定されている場合に送信されます。サブスクリプションが再開されるまでインボイスは作成されません。支払いの回収が一時停止されている場合、その期間中もインボイスは引き続き作成されるため、このイベントは送信されません。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.resumed | 以前に paused ステータスであったサブスクリプションが再開されると送信されます。これは、支払いの回収の一時停止が解除された場合には該当しません。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.trial_will_end | トライアル期間終了の 3 日前に送信されます。トライアル期間が 3 日未満の場合、このイベントがトリガーされます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
customer.subscription.updated | サブスクリプションが開始または変更された場合に送信されます。たとえば、サブスクリプションの更新、クーポンの追加、割引の適用、インボイスアイテムの追加、プランの変更はすべて、このイベントのトリガーです。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
entitlements.active_entitlement_summary.updated | Sent when a customer’s active entitlements are updated. When you receive this event, you can provision or de-provision access to your product’s features. Read more about integrating with entitlements. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.created | 新規または更新サブスクリプションに対してインボイスが作成されると送信されます。Stripe で invoice.created に対する成功応答を受信できない場合、自動請求が指定されたすべてのインボイスの確定が最大 72 時間遅延します。インボイスの確定についてご確認ください。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.finalized | インボイスの確定に成功し、支払いの準備が整うと送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.finalization_failed | インボイスを確定することができませんでした。ガイドを参照して、インボイスの確定失敗を処理する方法をご確認ください。インボイス概要ガイドのインボイスの確定に関する詳細をご確認ください。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.paid | インボイスの支払いに成功すると送信されます。このイベントを受け取り、サブスクリプションの status が active になると、商品へのアクセスを提供できます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.payment_action_required | インボイスに顧客の認証が必要なときに送信されます。インボイスでアクションが必要な場合にサブスクリプションを処理する方法をご確認ください。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| インボイスに対する支払いが失敗しました。PaymentIntent のステータスは
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.upcoming | サブスクリプションの更新の数日前に送信されます。何日前に送信されるかは、ダッシュボードの次回の更新イベントに設定された数値に基づきます。既存のサブスクリプションについては、日数の変更は次の請求期間から有効になります。必要に応じて、さらにインボイスアイテムを追加することもできます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
invoice.updated | 支払いが成功または失敗したときに送信されます。支払いが成功の場合には、paid 属性が true に、status が paid に設定されます。支払いが失敗の場合には、paid が false に、status は open のままになります。また、支払いの失敗は、invoice.payment_failed イベントもトリガーします。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
payment_intent.created | PaymentIntent (支払いインテント) が作成されると送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
payment_intent.succeeded | PaymentIntent が正常に支払いを完了すると送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.aborted | サブスクリプションスケジュールが、支払いの滞納により関連するサブスクリプションが終了となったことが原因でキャンセルされた場合に送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.canceled | サブスクリプションスケジュールがキャンセルされ、それに関連するアクティブなサブスクリプションもキャンセルされた場合に送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.completed | サブスクリプションスケジュールのすべてのフェーズが完了した場合に送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.created | 新しいサブスクリプションスケジュールが作成された場合に送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.expiring | サブスクリプションスケジュールが無効になる 7 日前に送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.released | サブスクリプションスケジュールがリリース (停止) され、そのまま残るサブスクリプションから関連付けが解除された場合に送信されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
subscription_schedule.updated | サブスクリプションスケジュールが更新された場合に送信されます。 |
インボイスのライフサイクル
インボイスの概要にはインボイスの仕組みの詳細が記載されていますが、サブスクリプションによって生成されたインボイスの基本的なライフサイクルは以下のようになります。
- サブスクリプションによって、
draft
ステータスの新しいインボイスが生成されます。 - インボイスは、作成されてから約 1 時間後に確定されます (変更はできなくなります)。
- ステータスは
open
に設定され、Stripe はデフォルトの支払い方法を使用して自動的に支払いを試みます。 - 支払いが成功すると、ステータスは
paid
に更新されます。 - 支払いが失敗すると、インボイスは
open
のままで、サブスクリプションがpast_due
になります。
このフローでは、Stripe はインボイスについて顧客に通知しません。インボイスが生成された直後に、決済が自動的に行われます。ただし、顧客のメールが有効になっている場合は、Stripe からメールの領収書が送信されます。
サブスクリプションの設定と回収
サブスクリプションの設定で、支払いが失敗したとき、またはサブスクリプションの期日が過ぎたときの Stripe の対応方法を定めます。
Smart Retries
サブスクリプションの作成後に発生する最も重要なイベントは、支払いの失敗です。失敗はさまざまな理由から発生します。
- 顧客に決済手段がありません。
- 決済手段の有効期限が切れています。
- 決済が拒否されました。
失敗した支払いを再試行するように、Stripe を設定することができます。Smart Retries は Stripe の機械学習を使用して、初回の支払いが失敗した後、最大 1 カ月の設定可能な期間にわたって、再試行に最適な時期を選択します。
カスタムルールで再試行スケジュールを変更することもできます。前回の実施から特定の日数を空けて、最大 3 回の再試行を設定できます。
回収に失敗した場合には、サブスクリプションが設定に基づいて遷移します。オプションは以下の通りです。
設定 | 説明 |
---|---|
サブスクリプションをキャンセル | リトライスケジュールで定義された最大日数の経過後にサブスクリプションは canceled ステータスに変わります。 |
サブスクリプションを未払いとしてマーク | リトライスケジュールで定義された最大日数の経過後にサブスクリプションは unpaid ステータスに変わります。インボイスが引き続き生成されますが、下書きの状態で保持されます。 |
サブスクリプションを期日超過のままにする | リトライスケジュールで定義された最大日数の経過後もサブスクリプションは past_due ステータスに保持されます。インボイスが引き続き生成され、リトライ設定に従って顧客に請求されます。 |
最後の支払いが行われた後、新しい支払い方法を顧客に追加するまでは、それ以降の支払いは実施されません。サブスクリプションの設定を変更した場合、それ以降の再試行にのみ影響します。インボイスに対して支払いが行われると、その next_payment_attempt 値は、ダッシュボードの現在のサブスクリプション設定に基づいて設定されます。
メール
オプションとして Stripe は、Customer (顧客) オブジェクトに関連付けられているメールアドレスを使用して、さまざまなメールを顧客に送信できます。
invoice.upcoming
イベントの送信と同時に送られる次回の更新リマインダー。- 顧客に支払い情報を更新するように促す、失敗した支払いに関する通知。詳細については、支払い失敗通知を有効にする方法をご覧ください。
- 顧客の
default_source
カードの有効期限が近づいているときに送信する、カードの有効期限通知。
領収書のドキュメントに記載されているように、カードを更新するための URL をカスタマイズできるだけでなく、メールで使用するロゴや色も更新できます。
手動の支払い
send_invoice
回収方法を使用して手動の支払いを受け取るインボイスに期限を設定できます。期日の 10 日前から 60 日後の間で 3 回までリマインダーを設定することもできます。
また、インボイスの期日が過ぎてから 30 日後、60 日後、または 90 日後にサブスクリプションに対して追加のアクションを実行することもできます。選択肢は次のとおりです。
設定 | 説明 |
---|---|
サブスクリプションをキャンセル | リトライスケジュールで定義された最大日数の経過後にサブスクリプションは canceled ステータスに変わります。 |
サブスクリプションを未払いとしてマーク | リトライスケジュールで定義された最大日数の経過後にサブスクリプションは unpaid ステータスに変わります。インボイスが引き続き生成されますが、draft ステータスで保持されるか、インボイス設定で指定されているステータスに移行します。 |
サブスクリプションを期日超過のままにする | リトライスケジュールで定義された最大日数の経過後もサブスクリプションは past_due ステータスに保持されます。インボイスが引き続き生成され、open ステータスになります。 |
サブスクリプションのステータスの詳細をご覧ください。
3D セキュアを必要とする支払い
3D セキュアを必要とする決済の場合、Stripe は、invoice.payment_action_required
を送信すると同時に、顧客に確認メールを送信できます。さらに、支払い開始後 1 〜 7 日間に、最大 3 回のリマインドメールを設定できます。
設定された日数が経過しても支払いが完了していない場合、以下を選択することができます。
設定 | 説明 |
---|---|
サブスクリプションをキャンセル | リトライスケジュールで定義された最大日数の経過後にサブスクリプションは canceled ステータスに変わります。 |
サブスクリプションを未払いとしてマーク | リトライスケジュールで定義された最大日数の経過後にサブスクリプションは unpaid ステータスに変わります。インボイスが引き続き生成されますが、下書きの状態で保持されます。 |
サブスクリプションを期日超過のままにする | リトライスケジュールで定義された最大日数の経過後もサブスクリプションは past_due ステータスに保持されます。インボイスが引き続き生成され、リトライ設定に従って顧客に請求されます。 |
トライアル
カードネットワークでは、トライアルについて顧客に知らせることが必要とされています。Stripe は、お客様に代わってこのコミュニケーションを管理できます。Stripe ダッシュボードで、リマインドメールとトライアル終了後の初回インボイスに対する領収書の両方に記載される、キャンセル URL を設定することができます。また、トライアル後の初回の支払いに使用する明細書表記も設定できます。これらの要件と設定の詳細については、トライアルページをご覧ください。
サブスクリプションを変更する
Stripe では、サブスクリプションをキャンセルしたり再作成したりしなくても、既存のサブスクリプションを変更することができます。最も重要な変更の中には、サブスクリプション価格のアップグレードやダウングレード、アクティブなサブスクリプションのキャンセルや支払いの回収の一時停止が含まれます。既存のサブスクリプションを変更する方法についてご確認ください。