36 lines
1.9 KiB
Markdown
36 lines
1.9 KiB
Markdown
|
---
|
|||
|
|
sidebar_position: 7
|
|||
|
|
title: "請求と支払い"
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 請求、請求書、支払い
|
|||
|
|
|
|||
|
|
請求データの表示、更新、正確性の維持方法を説明します。
|
|||
|
|
|
|||
|
|
## データソース
|
|||
|
|
|
|||
|
|
- WHMCSがクライアント、請求書、支払い方法、ゲートウェイ、サブスクリプションの請求管理システムです。
|
|||
|
|
- ポータルは支払い詳細を保存しません。WHMCSに既に保存されている支払い方法のみ読み取ります。
|
|||
|
|
|
|||
|
|
## 請求書
|
|||
|
|
|
|||
|
|
- 取得：マッピングされたクライアントID用の請求書一覧と詳細をWHMCSから取得。
|
|||
|
|
- キャッシュ：一覧は90秒、個別請求書は5分キャッシュ。WHMCSのWebhookと書き込み操作でキャッシュをクリア。
|
|||
|
|
- 請求書の支払い：ポータルが特定の請求書用のWHMCS SSOリンクを生成し、顧客が認証情報を再入力せずにWHMCSで直接支払い可能。
|
|||
|
|
|
|||
|
|
## 支払い方法 & ゲートウェイ
|
|||
|
|
|
|||
|
|
- 支払い方法はWHMCSに保存。注文受付前に少なくとも1つの方法が存在することを確認。
|
|||
|
|
- キャッシュ：支払い方法はユーザーごとに15分、決済ゲートウェイ一覧は1時間キャッシュ。
|
|||
|
|
|
|||
|
|
## 請求における住所 & プロフィール
|
|||
|
|
|
|||
|
|
- ポータルに表示される請求先住所と連絡先フィールドはWHMCSから取得され権威的に扱われます。
|
|||
|
|
- プロフィール/住所を編集すると、ポータルがWHMCSに変更を書き込みキャッシュをクリアし、請求書に即座に新しい住所が反映。
|
|||
|
|
|
|||
|
|
## エラー時の動作
|
|||
|
|
|
|||
|
|
- WHMCS利用不可：「請求システムが利用できません、やり直してください」を表示。
|
|||
|
|
- 支払い方法不足：チェックアウト/フルフィルメントを停止し支払い方法の追加を促す。
|
|||
|
|
- 請求書が見つからない：他のユーザーデータを漏洩せずに「請求書が見つかりません」を返却。
|