請求関連のFAQ

Q. メータ単位の「使用量の集計」設定（sum/max）はどのような機能でしょうか？
A. メータ単位の「使用量の集計」設定は、メータリングデータの集計方法を指定する機能です。

Stripe連携を有効にしている場合にUI上で設定できる「使用量の集計」方法（sumまたはmax）は、Stripeへの請求額を計算するだけでなく、メータリング関連APIで取得できるcountの値の計算方法も決定します。

なお、Stripe連携を有効にしていない場合、この設定項目はUI上に表示されませんが、集計方法はデフォルトでsum（合計）となります。

具体的には、以下のAPIで返されるcountの値が集計設定に応じて変わります。

集計方法によるcountの値の違い

sum（合計）を設定した場合:
APIは、指定された期間内（日次または月次）に記録されたメータリングの値を合計したcountを返します。

max（最大）を設定した場合:
APIは、指定された期間内（日次または月次）に記録されたメータリングの値の最大値をcountとして返します。

Q. SaaSus PlatformとStripeの役割分担はどうなっていますか？
A. SaaSus Platformは「利用プラン」の管理を行い、Stripeは「決済・請求実務」を担います。販売モデル（セルフサーブ型／セールス主導型）によって、SaaSus Platformの機能をどこまで活用できるかが異なります。

セルフサーブ型（自動化推奨）: SaaSus Platformの料金プラン定義に基づき、サブスクリプションの作成や更新を自動実行できます。
セールス主導型（手動対応）: SaaSus Platformでは顧客ID（Stripe Customer）の紐付けのみを行い、具体的な請求書作成や複雑な料金設定はStripeダッシュボードから直接行います。

Q. 請求先情報（社名や住所）の登録・管理はどうすればよいですか？
A. 販売モデルによって登録経路が異なりますが、情報はSaaSus Platform経由でStripeへ同期されます。なお、セキュリティリスクを最小限にするため、クレジットカード情報はSaaSus Platform側では保持せず、Stripeの画面で直接入力させる仕組みとなっています。

セルフサーブ型: エンドユーザーがアプリ上の入力画面から登録します。
セールス主導型: 営業担当者が「SaaS運用コンソール」から代理入力します。

Q. 3Dセキュア（本人認証）などの決済画面はSaaSus Platformで提供されますか？
A. いいえ、SaaSus Platformは決済用の認証画面（ポップアップ等）を表示する機能を持っていません。バックエンドでの決済作成指示は行いますが、ブラウザ上での認証が必要な場合は、Stripeの提供する機能（Hosted Invoice Page等）を組み込んで対応いただく必要があります。

Q. 決済完了時にサンクスメールを送りたいのですが、SaaSus PlatformからWebhookは通知されますか？
A. いいえ、SaaSus PlatformはStripeのWebhookイベントを中継しません。決済完了時の即時メール送信や、返金検知などのリアルタイム処理が必要な場合は、自社サーバーでStripe Webhookを直接受信する実装が必要となります。

Q. 返金処理や請求書の再発行、クーポン適用はコンソールから行えますか？
A. いいえ、それらのイレギュラーな操作や個別対応は、直接Stripeダッシュボードで行う必要があります。

返金・請求書再発行: SaaSus Platformには機能がないため、Stripe側で直接操作してください。
請求書払い: クレジットカード決済以外（銀行振込等）の請求書送付も、Stripe側で行う必要があります。
クーポン（割引）: 特定のテナントへの個別割引は、Stripeダッシュボードにて対象のCustomerやサブスクリプションに紐付けてください。

Q. 料金プランを作成しようとすると internal error が発生します。解決方法はありますか？

A. SaaSus Platform と Stripe の間でデータの不整合が発生している可能性があります。特に、Stripeダッシュボードで直接リソースを操作した場合に、以下のような原因でエラーが発生することがあります。

主な原因
- メーター（計量項目）名の重複
  SaaSus Platform で定義しようとしているメーター名（例：project_count など）が、既に Stripe 側に同名で存在している場合、プランの作成に失敗します。この場合は、Stripe 側の該当メーターを削除するか、SaaSus Platform 上で別のメーター名を作成してお試しください。
- Stripe での直接操作による影響
  SaaSus Platform を介さずに Stripe 管理画面から直接サブスクリプションの作成や、クーポン設定、プランの初期化などを行った場合、両システム間での同期が正しく行われなくなることがあります。
解決方法
データの不整合を解消するために、Stripe 連携を一度解除し、再接続を行う対応が必要になる場合があります。これにより、改めて正しいステータスで同期を試みることが可能です。

本番環境での実施に関する注意

本番環境で連携解除・再接続を行う場合は、既存の顧客データや請求ステータスに影響が出る可能性があるため十分に注意して作業を行ってください。

推奨される運用
設定の不整合を防ぐため、料金プランやメーターの定義、サブスクリプションの管理などは、可能な限り SaaSus 開発コンソール側から操作を行うことを推奨しております。

Q. 特定の顧客に対して「最初の数ヶ月間無料」や「期間限定の割引」などのキャンペーンを適用することはできますか？

A. 現在、SaaSus Platform では Stripe が提供している「クーポン」や「初回限定割引」などのプロモーション機能には対応しておりません。

対応している計測単位
SaaSus Platform では、以下の4つの計測単位に基づいた料金プランの設計が可能です。
- 固定ユニット (fixed): 月額基本料金などの固定額
- 使用量ユニット (usage): 1単位（ユーザー数など）ごとに加算される従量料金
- 段階ユニット (tiered): 利用量に応じて段階的に設定される定額料金
- 段階的使用量ユニット (tiered_usage): 利用量が増えるほど単価が変化するボリュームディスカウント形式
Stripeダッシュボードでの直接操作と注意点
SaaSus Platform で作成されたサブスクリプションに対して、Stripeダッシュボードから直接割引を適用するなどの変更を行うことは技術的に可能です。
ただし、サブスクリプションの「計測単位（単位や計算ロジック）」自体を変更する操作は絶対に行わないでください。 SaaSus Platform と Stripe の間でデータの整合性が取れなくなり、正しい請求やメーターの更新ができなくなる恐れがあります。
割引・キャンペーン運用の代替案
「初月無料」や「特定期間の割引」を実現したい場合は、SaaSus 開発コンソールにて、基本料金を「0円」に設定したキャンペーン専用の料金プランを別途作成し、対象となるテナントへ割り当てる運用をご検討ください。
今後の提供計画
Stripe のプロモーション機能との直接的な連携については、お客様からのニーズに合わせて今後の機能拡充のロードマップにて検討を進めております。

Q. SaaSus Platformで、銀行振込を有効にすることはできますか？

A. 現在、SaaSus Platform の管理画面上から直接「銀行振込」を有効化する機能は提供しておりません。ただし、連携している Stripeダッシュボードから直接設定を変更いただくことで、銀行振込による決済が可能になります。

設定の手順と注意点
SaaSus Platform で料金プランを設定（サブスクリプション作成）した後、Stripeダッシュボードでサブスクリプションが確定するまでの間（約1時間以内）に、対象のサブスクリプションに対して「銀行振込」を許可する設定を行ってください。
計測単位に関する重要な制限
Stripeダッシュボードから直接設定を変更する場合、SaaSus Platform で連携・定義されている「計測単位（単位や計算ロジック）」自体は絶対に変更しないでください。
計測単位を変更してしまうと、SaaSus Platform と Stripe の間でデータの不整合が発生し、正しくメーターの更新や請求が行えなくなる恐れがあります。

Q. 将来的に米国（US）や欧州（EU）へのグローバル展開を予定していますが、各国の現地通貨での決済に対応していますか？

A. SaaSus Platform では、主要な決済通貨である**日本円（JPY）および米ドル（USD）**に対応した料金プランの作成が可能です。

Stripe連携による通貨運用
Stripe と連携することで、日本国内向けの展開だけでなく、米ドル（USD）を利用した広範なグローバルビジネスの収益化モデルを SaaSus コンソールから一元管理できます。
提供エリアとコンプライアンスについて
現在は ap-northeast-1（東京リージョン）を中心としたサービス提供を行っております。米国（US）など多くの地域からは共通のエンドポイントをご利用いただけますが、欧州（EU）圏内につきましては、GDPR（一般データ保護規則）への厳格な対応およびセキュリティガバナンスの観点から、現在は API アクセスをブロックさせていただいております。
今後の展開について
お客様のビジネス成長に合わせたサポートエリアや対応通貨の拡大については、各国の法規制の動向を注視しつつ、順次検討を進めております。特定の地域での利用計画や法規制への対応に関するご要望がございましたら、個別に対応を検討させていただきますので、お問い合わせください。

Q. 計測の単位を「ユーザー単位」に設定し、個別の利用状況を分析することはできますか？

A. いいえ、SaaSus Platform のメータリング機能（計量項目）は、現在テナント単位での集計のみに対応しております。ユーザー個別の利用状況を直接計測・集計する機能は提供しておりません。

ユーザー単位の分析を実現する方法
特定のユーザーによるリソース消費量や行動ログを詳細に分析したい場合は、SaaSus Platform の外部（お客様のアプリケーション側）でログを蓄積・集計する仕組みの構築を推奨しております。

Q. SaaSus Platformの管理コンソールから、過去の領収書や請求書をダウンロードすることはできますか？

A. 現在、SaaSus Platform の管理コンソール内には、お客様ご自身で直接領収書をダウンロードできる画面は提供しておりません。お手数ですが、以下の方法にてご確認・取得をお願いいたします。

自動送信メールによる確認
お支払い完了時に、連携している Stripe より領収書メールが自動送信されます。まずは、ご登録いただいているメールアドレスの受信ボックスをご確認ください。
※Stripe の管理コンソール内（設定＞メール）にて、「支払いの成功」時にお客様へメールを送信する設定が有効になっている必要があります。届いていない場合は、Stripe 側の設定をご確認ください。
なお、Stripe の仕様変更により、設定項目の名称や場所が変更される可能性がありますので、最新の Stripe ドキュメントも併せてご参照ください。
Stripe 管理コンソールからのダウンロード
管理者の皆様におかれましては、連携済みの Stripe 管理コンソールへログインいただくことで、対象の支払い（Payment）に関連付けられた領収書や請求書をいつでも PDF 形式でダウンロードすることが可能です。

Q. 月の途中でプランのアップグレードやダウングレードを行った場合、請求や日割り計算はどうなりますか？

A. SaaSus Platform では、Stripe の機能を利用した日割り計算に対応しています。
運用コンソールからの操作、または API のパラメータ設定により、差額の請求タイミングをコントロールすることが可能です。
※ 運用コンソールからの操作は即時請求となります。

日割り計算のロジック（計算例）
計算は Stripe の標準ロジック（秒単位計算）に基づきます。
例：3月1日にプランA（25,000円）を契約し、3月21日にプランB（28,000円）へ変更した場合（3月は31日間）

アップグレードの場合 (プランA → プランB)
プランA（旧）の未使用分払い戻し：約 -8,064円
プランB（新）の残り期間利用分：約 +9,032円
差額（調整額）：+968円が発生します。
ダウングレードの場合 (プランB → プランA)
差額が -968円となり、このマイナス分は「未使用のクレジット」として Stripe 内に保持されます。
次回の定期請求（4月1日分）の際に、このクレジットが充当されます。
例：4月分 25,000円 - クレジット 968円 = 請求額 24,032円

プラン変更時の挙動設定（proration_behavior）
テナントのプラン情報を更新APIを使用してプランを変更する際、パラメータ proration_behavior(プラン変更時の比例配分の挙動) の値によって、請求のタイミングを指定できます。

proration_behavior	請求方法	詳細
always_invoice	即時請求	プラン変更した瞬間に、日割り計算された差額分の請求書が発行・決済されます。
create_prorations	次回合算	差額は計算されますが、即時請求はされません。次回の定期請求タイミングで合算されます。
none	日割りなし	変更時点での日割り計算を行いません。次回の定期請求から新プランの定額料金が適用されます。

Q. 利用実績がない従量課金メニュー（0円）を、Stripe の請求書から非表示にすることはできますか？

A. いいえ、現在の SaaSus Platform および連携先の Stripe の仕様により、利用がない項目（0円）を請求書から非表示にすることはできません。

Q. 年次契約のプランに、月額固定のオプションや従量課金（使用量ユニット）を組み合わせることはできますか？
A. 請求の透明性と一貫性を保つため、SaaSus Platform（および連携するStripe）では、1つのサブスクリプション内で異なる請求サイクル（年次と月次など）を組み合わせることはできません。