---
sidebar_position: 7
title: "請求と支払い"
---

# 請求、請求書、支払い

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

## データソース

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

## 請求書

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

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

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

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

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

## エラー時の動作

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