Assist_Design/docs/ja/how-it-works/billing-and-payments.md

sidebar_position, title

sidebar_position	title
7	請求と支払い

請求、請求書、支払い

請求データの表示、更新、正確性の維持方法を説明します。

データソース

• WHMCSがクライアント、請求書、支払い方法、ゲートウェイ、サブスクリプションの請求管理システムです。
• ポータルは支払い詳細を保存しません。WHMCSに既に保存されている支払い方法のみ読み取ります。

請求書

• 取得：マッピングされたクライアントID用の請求書一覧と詳細をWHMCSから取得。
• キャッシュ：一覧は90秒、個別請求書は5分キャッシュ。WHMCSのWebhookと書き込み操作でキャッシュをクリア。
• 請求書の支払い：ポータルが特定の請求書用のWHMCS SSOリンクを生成し、顧客が認証情報を再入力せずにWHMCSで直接支払い可能。

支払い方法 & ゲートウェイ

• 支払い方法はWHMCSに保存。注文受付前に少なくとも1つの方法が存在することを確認。
• キャッシュ：支払い方法はユーザーごとに15分、決済ゲートウェイ一覧は1時間キャッシュ。

請求における住所 & プロフィール

• ポータルに表示される請求先住所と連絡先フィールドはWHMCSから取得され権威的に扱われます。
• プロフィール/住所を編集すると、ポータルがWHMCSに変更を書き込みキャッシュをクリアし、請求書に即座に新しい住所が反映。

エラー時の動作

• WHMCS利用不可：「請求システムが利用できません、やり直してください」を表示。
• 支払い方法不足：チェックアウト/フルフィルメントを停止し支払い方法の追加を促す。
• 請求書が見つからない：他のユーザーデータを漏洩せずに「請求書が見つかりません」を返却。