# Metronome と Stripe の連携 Metronome を使えば、Stripe による決済回収向けの従量課金を利用できます。 Metronome と Stripe は、高度な料金モデル向けにエンドツーエンドの請求機能を提供します。Metronome は従量課金、クレジットベースの料金体系、企業向け契約、多次元レーティングを処理します。Stripe は決済の回収、税金計算、収益認識、データエクスポートを処理し、[Radar](https://docs.stripe.com/radar.md) による不正利用のスクリーニングも支援します。 お客様の請求モデルと成長戦略が、Metronome と Stripe の連携方法の選択に影響します。 ## Metronome が対応する請求モデル Metronome は、プロダクト主導型成長 (PLG) とセールス主導型成長 (SLG) の両方の戦略向けの請求モデルに対応しています。これらのモデルを組み合わせることで、単一のシステム内でさまざまな顧客セグメントとライフサイクルステージに対応できます。 ### セルフサービスおよび PLG モデル - 自動回収を伴う完全な従量課金 - 利用に応じて残高が消費されるプリペイドクレジットウォレット - 残高が閾値を下回ったときの自動チャージ - 決済の成功後にのみクレジットが付与される、決済を条件としたクレジット購入 - リスク上限を設定し、想定外の高額請求を抑える利用額閾値モデル - トライアル、ティアのアップグレードとダウングレード、プリペイドと超過分請求のハイブリッドを含むサブスクリプションのライフサイクル [プリペイド残高の閾値](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds)と[プリペイドコミットの作成](https://docs.metronome.com/guides/pricing-packaging/apply-credits-and-commits/create-a-pre-paid-commit)を参照してください。 ### 営業主導モデルとエンタープライズモデル - 最低利用額の契約と超過分の精算請求を伴う後払いコミット - 消費と超過分請求を伴うプリペイドのエンタープライズコミット - 後払い条件に基づく使用量ベースの請求書発行 - スコープ間の優先ルールを持つマルチウォレットクレジットアーキテクチャ (例: ユーザーごとのプールを優先し、次に組織レベルのコミット) - 地域別または契約固有の設定に対応する、複数事業体および複数 Stripe の構成 [エンタープライズコミット](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/enterprise-commit)と[プロダクトと契約の作成](https://docs.metronome.com/guides/get-started/core-concepts/create-products-contracts)を参照してください。 多くの企業は、両方の成長戦略を並行して運用しています。たとえば、利用額のしきい値付きの無料トライアルからユーザーに開始してもらい、自動チャージ付きのプリペイドクレジットに移行し、大手顧客にはコミットメント契約へ移行してもらうといった形です。詳しい手順については、[Billing モデルガイド](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/guides-home)を参照してください。 ## 連携パターン Metronome は Stripe と併用して、次の 2 つの方法で運用できます。 - **Metronome 単独**: Metronome がすべての請求と使用量計測を担い、決済回収のために確定済みの請求書を Stripe に送信します。 - **Metronome と Stripe Subscriptions の併用**: Stripe Subscriptions が継続的なシートベースまたは定額の請求を処理します。Metronome はこれと並行して動作し、従量課金の使用量計測と請求を個別に処理します。両方のシステムが同じ Stripe 顧客に対して請求書を作成します。 両方のパターンで同じ仕組みを使用します。Metronome は[確定済みの請求書](https://docs.metronome.com/integrations/invoice-integrations/stripe)を [Invoicing API](https://docs.stripe.com/api/invoices.md) を通じて Stripe に送信します。この請求書同期は一方向であり、Stripe が請求書データを Metronome に送り返すことはありません。詳細については、[請求の仕組み](https://docs.metronome.com/guides/get-started/core-concepts/how-invoicing-works)を参照してください。 Stripe に送信されたすべての Metronome 請求書について、Stripe の決済ステータスが自動的に Metronome に同期されます。 ### 各パターンの選択基準 既存の従量課金システムから移行する場合、またはゼロから始める場合は、**Metronome 単独**を選択できます。このパターンでは Metronome の請求プラットフォーム機能を幅広く利用できますが、Checkout など一部の Stripe サーフェスではカスタム連携作業が必要です。アーキテクチャ計画のガイダンスについては、[請求アーキテクチャの計画](https://docs.metronome.com/guides/implement-metronome/planning-your-billing-architecture)を参照してください。 継続課金に Stripe Subscriptions をすでに使用しており、それに加えて従量制の料金体系を追加したい場合は、**Metronome と Stripe Subscriptions の併用**を選択できます。既存のサブスクリプションフロー (Checkout、Adaptive Pricing、Payment Links を含む) はそのまま利用でき、Metronome が使用量計測と請求を個別に処理します。 ### Metronome 単独 使用量イベントを Metronome に送信します。Metronome はそれらを使用量計測、料金計算、契約ロジックを通じて処理し、請求書を確定して Invoicing API を通じて Stripe に送信します。Stripe は決済回収、税金、収益認識、レポート作成を処理します。 ### Metronome と Stripe Subscriptions の併用 Stripe Subscriptions は継続課金の料金体系を管理します。顧客は既存のフロー (Checkout、Payment Links、または API) を通じて登録します。別途、使用量イベントを Metronome に送信します。Metronome はそれらを処理し、同じ Stripe Customer に対して使用量請求書を Stripe に送信します。顧客はサブスクリプション請求書 (Stripe から) と使用量請求書 (Metronome から) の両方を受け取ります。 #### Metronome と Stripe Subscriptions を設定する 1. Metronome の顧客を作成するタイミングを決定します。最も一般的なパターンは、Stripe で新しいサブスクリプションが作成されたときに、これらのオブジェクトを作成することです。Stripe はこれらのイベントについて [Webhook を送信](https://docs.stripe.com/billing/subscriptions/webhooks.md)するため、これを使用して Metronome での作成を開始できます。Stripe 顧客 ID が Metronome の顧客に追加されていることを確認してください。 1. 顧客が作成されたら、関連するクレジットまたはコミットを追加した契約を作成します (該当する場合)。 1. 新しい顧客の使用量データの送信を開始します。Metronome は、契約とレートカードに従って使用量を収集、集計し、料金を計算します。 1. 金額がゼロでない請求書はすべて、これらの顧客の請求期間の終了時に自動的に Stripe に転送されます。 ## Stripe プロダクトとの相互運用性 | Stripe プロダクト | 対応レベル | 備考 | | --------------------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [請求](https://docs.stripe.com/invoicing.md) | 完全対応 | Metronome の請求書は Stripe の標準請求書になります。売掛金、回収、督促を管理します。 | | [税金](https://docs.stripe.com/tax.md) | 完全対応 | 請求書の確定時に税金を計算します。[Anrok](https://docs.metronome.com/integrations/tax-integrations/anrok) と [Avalara](https://docs.metronome.com/integrations/tax-integrations/avalara) にも対応しています。 | | [決済](https://docs.stripe.com/payments.md) | 完全対応 | 決済を処理し、[Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) で再試行し、[Radar](https://docs.stripe.com/radar.md) で不正利用をスクリーニングします。 | | [Revenue Recognition](https://docs.stripe.com/revenue-recognition.md) | 完全対応 | ASC 606 / IFRS 15 スケジュールを生成します。追加の設定は不要です。 | | [Data Pipeline と Sigma](https://docs.stripe.com/stripe-data.md) | 一部対応 | Stripe の請求書、チャージ、決済データにクエリを実行します。Metronome 固有のデータ (メータリングイベント、契約状態、クレジット台帳) には、[Metronome データエクスポート](https://docs.metronome.com/guides/reporting-insights/data-export/overview)が必要です。 | | [checkout](https://docs.stripe.com/payments/checkout.md) | カスタム実装が必要 | Checkout はサブスクリプション登録と 1 回限りの決済向けに設計されています。Metronome の請求書では、Checkout ではなく、Stripe の請求書の決済フロー (自動請求またはオンライン請求書ページ) を使用します。 | | [Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) | 直接は適用されません | Adaptive Pricing は決済時に価格を換算します。Metronome の請求書は、金額がすでに計算された状態で届きます。 | 弊社は Stripe との相互運用性を積極的に向上させています。 ## Stripe 開発者向けの Metronome の概念 | Stripe の対応概念 | Metronome の概念 | 定義 | | ------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | | [メーター](https://docs.stripe.com/api/billing/meter.md) | [課金対象メトリクス](https://docs.metronome.com/guides/get-started/core-concepts/create-billable-metrics) | 顧客の使用量 (API コール数、トークン数、GB 時間) の集計方法を定義します。SUM、COUNT、MAX、UNIQUE に対応しています。 | | [Price](https://docs.stripe.com/api/prices.md) | [レート](https://docs.metronome.com/guides/get-started/core-concepts/create-manage-rate-cards) | 再利用可能な料金テンプレートである **Rate Card** を通じて課金対象メトリクスに紐付けられた価格です。 | | [サブスクリプション ](https://docs.stripe.com/api/subscriptions.md)(大まかな対応) | [契約](https://docs.metronome.com/guides/get-started/core-concepts/create-products-contracts) | レートカード、コミット、クレジット、スケジュールを定義するエンタープライズ契約です。 | | [CreditGrant](https://docs.stripe.com/api/billing/credit-grant.md) | [プリペイドコミット](https://docs.metronome.com/guides/pricing-packaging/apply-credits-and-commits/create-a-pre-paid-commit) | コミット使用量に対する前払いです。クレジットは時間の経過とともに消費されます。 | | 直接の対応概念なし | [ポストペイドコミット](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/enterprise-commit) | 最低利用金額の契約。使用量が不足した場合は差額の請求書が発行されます。 | | [クレジット残高](https://docs.stripe.com/api/billing/credit-balance-summary.md) | [クレジット台帳](https://docs.metronome.com/api-reference/credits-and-commits/list-balances) | クレジット残高、消費、有効期限切れ、繰り越しを追跡します。 | | 直接の対応概念なし | [しきい値請求](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds) | クレジット残高がしきい値を下回ると自動チャージされます。 | | 直接の対応概念なし | [ディメンション別料金体系](https://docs.metronome.com/guides/pricing-packaging/overview) | 同一メトリクスに対して属性ディメンション別に価格が変動します。 | ## 請求書のライフサイクル 請求書のライフサイクルは、どちらの連携パターンでも同じです。 1. **請求書の確定**: 請求期間の終了時 (または契約スケジュールに基づいて)、Metronome が請求書を計算し、確定します。 1. **項目の作成**: Metronome は Stripe API を通じて Stripe 顧客に [InvoiceItem](https://docs.stripe.com/api/invoiceitems.md) オブジェクトを作成します。Invoice オブジェクト自体より先にすべての項目が作成されるため、下流のリスナー (税務プロバイダー、Webhook) は作成時に完全な請求書を参照できます。 1. **請求書の作成**: Metronome は Stripe 顧客に対して [POST /v1/invoices](https://docs.stripe.com/api/invoices/create.md) を呼び出します。これにより、保留中のすべての項目が自動的に添付されます。 1. **検証**: Metronome は、Stripe の請求書合計が Metronome の請求書合計と丸め誤差の許容範囲内で一致することを検証します。 1. **確定**: 設定に応じて、請求書は自動的に確定されるか、手動レビューのために下書きステータスのままになります。税務プロバイダー (Stripe Tax、Anrok、Avalara のいずれか) が設定されている場合、税務プロバイダーが税金を適用するまで確定が延期されることがあります。 1. **Webhook の取り込み**: Metronome は Stripe の Webhook (`invoice.finalized`、`invoice.paid`、`invoice.payment_failed`、`invoice.payment_succeeded`、`invoice.voided`、`invoice.marked_uncollectible`、`invoice.deleted`) を監視し、決済ステータスを追跡して請求書レコードを更新します。Webhook とステータスの完全な対応関係については、[Stripe の請求書のステータス追跡](https://docs.metronome.com/integrations/invoice-integrations/stripe#track-stripe-invoice-statuses-in-metronome)を参照してください。 ### 請求書の属性 次の表は、Metronome が Stripe に請求書を送信した後、各請求書属性をどのシステムが管理するかを示しています: | 請求書の属性 | 管理元 | | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 項目 (名称、数量、単価) | Metronome | | サブ項目の内訳 (段階制料金体系、表示グループキー) | Metronome ([グループキー](https://docs.metronome.com/guides/get-started/core-concepts/create-products-contracts#group-keys)で設定可能) | | 請求書メタデータ (`metronome_invoice_id`、`client_id`、`environment`) | Metronome ([エンティティマッピングルール](https://docs.metronome.com/integrations/invoice-integrations/stripe#create-optional-entity-mapping-rules)) | | 項目のサービス期間の日付 | Metronome | | 回収方法 (`send_invoice` または `charge_automatically`) | [顧客ごとに設定可能](https://docs.metronome.com/integrations/invoice-integrations/stripe#set-the-customer-billing-configuration) | | 支払期日までの日数 (例: Net 30) | [顧客ごとに設定可能](https://docs.metronome.com/integrations/invoice-integrations/stripe#configure-optional-global-integration-settings-available) | | 下書きまたは自動確定の動作 | [アカウントレベルの設定](https://docs.metronome.com/integrations/invoice-integrations/stripe#configure-optional-global-integration-settings-available) | | 税金の計算 | [Stripe Tax](https://docs.metronome.com/integrations/tax-integrations/stripe-tax)、[Anrok](https://docs.metronome.com/integrations/tax-integrations/anrok)、または [Avalara](https://docs.metronome.com/integrations/tax-integrations/avalara) (Metronome が項目を作成した後に適用) | | 決済手段、Radar による不正利用スクリーニング、[Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) | Stripe | | 請求書の表示、ブランディング、ヘッダー / フッター | Stripe | | 請求書で利用可能な決済手段 | Stripe | ## 決済 Metronome の請求書が Stripe で確定されると、以下の Stripe の決済機能を利用できます。 - **自動回収**: 顧客のデフォルト決済手段を使用します。Metronome は、`charge_automatically`(Stripe が決済手段に請求する) と `send_invoice`(Stripe が顧客にメールを送信する) の両方の[回収方法](https://docs.metronome.com/integrations/invoice-integrations/stripe#set-the-customer-billing-configuration)に対応しています。 - [**Smart Retries**](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md): Stripe は機械学習を使用して、失敗した決済の最適な再試行タイミングを選択します。 - [**督促と売上回収**](https://docs.stripe.com/billing/revenue-recovery.md): Stripe が決済失敗を知らせるメールを送信し、再試行のライフサイクルを管理します。お客様の Stripe アカウントで [Stripe の督促と売上回収](https://docs.stripe.com/billing/revenue-recovery.md)を有効にすると、決済失敗後のフォローアップを自動化できます。 - **Radar**: カード決済の不正利用をスクリーニングします。 - **グローバルな決済手段**: Stripe の請求で対応しているすべての決済手段 (カード、ACH、SEPA、電信送金、その他) を利用できます。 - **決済手段の管理**: Stripe が顧客の決済手段の信頼できる唯一の情報源となります。 ### 決済を条件とするコミット Metronome は[決済を条件とするコミット ](https://docs.metronome.com/guides/pricing-packaging/apply-credits-and-commits/manual-payment-gated-commits)([しきい値請求と自動チャージ](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds)を含む) に対応しています。この仕組みでは、クレジットが利用可能になる前に Stripe の請求書の決済が完了している必要があります。13 日間の決済期間がある ACH にも対応しています。 決済を条件とする自動チャージの決済が失敗した場合、Metronome は請求書を無効化し、契約の自動チャージを無効にします。顧客にフォローアップし、契約を手動で再度有効にする必要があります。ワークフロー全体については、[プリペイド残高しきい値](https://docs.metronome.com/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds)を参照してください。 ### 決済の失敗 Metronome は Webhook を通じて Stripe の請求書の決済ステータスを追跡します。Stripe が決済の回収と再試行ロジックを処理します。失敗時の処理は請求書の設定によって異なります。 - **`charge_automatically` の請求書**: Stripe が再試行サイクルを管理します。[Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) が有効な場合、Stripe は機械学習を使用して最適な再試行タイミングを選択します (設定可能な期間内で最大 8 回の試行)。Metronome は `invoice.payment_failed` を受信し、請求書のステータスを `PAYMENT_FAILED` に更新しますが、再試行は行いません。 - **`send_invoice` の請求書**: Stripe が決済手順とともに請求書を顧客にメールで送信します。期日までに決済が行われない場合、請求書は Stripe で open ステータスのままになります。Metronome はステータスを追跡しますが、決済のリマインダーとフォローアップは Stripe の[督促と売上回収](https://docs.stripe.com/billing/revenue-recovery.md)によって処理されます。 - **決済を条件とするしきい値請求**: 決済を条件とする自動チャージの請求書の決済が失敗した場合、Metronome は契約の `is_enabled` フィールドを false に設定し、請求書を無効化します。その後、しきい値請求を送信できるようにするには、事前に再度有効にする必要があります。 Stripe への請求書送信でエラーが発生した場合 (例: Stripe の顧客が存在しない、または有効な決済手段がない場合)、Metronome は `invoice.billing_provider_error` Webhook を送信します。Stripe 内で完結するエラーは、[Stripe Webhook](https://docs.stripe.com/webhooks.md) を通じて直接報告されます。Metronome イベントの完全なリストについては、[Metronome webhook types](https://docs.metronome.com/guides/platform-configuration/setup-webhooks) を参照してください。 ### 請求書発行後の操作 Metronome が Stripe に請求書を送信した後、以下の操作を Stripe またはお客様の他のシステム (ERP や CRM など) で直接管理します。 - **返金**: ダッシュボードまたは [Refunds API](https://docs.stripe.com/refunds.md)、ERP、CRM を通じて Stripe で返金を処理します。Metronome 内で今後の請求にクレジットを適用するには、[クレジットメモを発行](https://docs.metronome.com/guides/invoices/invoice-optimization/issue-credit-memos)を参照してください。 - **請求書の調整**: [Metronome Credits API](https://docs.metronome.com/api-reference/credits-and-commits/create-a-credit) を使用してクレジットを発行し、Metronome で請求書を無効化して再生成し、Stripe に再同期します。 - **請求書の無効化**: Metronome と Stripe は、それぞれ独立した請求書レコードを保持しています。レコードの同期を保つため、両方のシステム (およびその他の下流システム) で請求書を無効化してください。 ## 始める 1. **請求アーキテクチャを計画する**: Metronome を独立して使用するか、使用量サイドカーとして使用するかを決定します。[請求アーキテクチャを計画する](https://docs.metronome.com/guides/implement-metronome/planning-your-billing-architecture)を参照してください。 1. **Metronome を Stripe に接続する**: [Stripe で請求書を発行する](https://docs.metronome.com/integrations/invoice-integrations/stripe)の手順に従ってください。 1. **税金を設定する**: [Stripe Tax](https://docs.metronome.com/integrations/tax-integrations/stripe-tax)、[Anrok](https://docs.metronome.com/integrations/tax-integrations/anrok)、または [Avalara](https://docs.metronome.com/integrations/tax-integrations/avalara) を設定します。 1. **Smart Retries を有効にする**: 決済成功率を最大化するために、[Smart Retries](https://docs.stripe.com/billing/revenue-recovery/smart-retries.md) を有効にします。 1. **データエクスポートを設定する**: [Metronome データエクスポート](https://docs.metronome.com/guides/reporting-insights/data-export/overview) と [Data Pipeline](https://docs.stripe.com/stripe-data/access-data-in-warehouse.md) を設定します。 1. **Webhook をリッスンする**: [Metronome Webhook](https://docs.metronome.com/guides/platform-configuration/setup-webhooks) と [Stripe ウェブフック](https://docs.stripe.com/webhooks.md) のリスナーを設定します。 1. **本番環境チェックリストを確認する**: [Metronome 本番環境チェックリスト](https://docs.metronome.com/guides/implement-metronome/production-checklist)を参照してください。 ## See also - [Metronome の仕組み](https://docs.metronome.com/guides/get-started/how-metronome-works) - [API クイックスタート](https://docs.metronome.com/guides/get-started/api-quickstart) - [請求モデルガイド](https://docs.metronome.com/guides/pricing-packaging/billing-model-guides/guides-home) - [Metronome API リファレンス](https://docs.metronome.com/api-reference/introduction)