TASHIKA Docs

Appearance

UC-952: 支払いを記録する ​

項目内容
領域サブスクリプション
アクターシステム（外部決済サービスからの通知）
レベルサブ機能
事前条件対象の請求レコードが存在すること
成功時の保証請求の支払い状態が更新されている
トリガー外部決済サービスからの入金通知（Webhook）

主成功シナリオ ​

  1. システムが外部決済サービスから入金通知を受信する
  2. システムが通知内容を検証する（署名検証、請求IDの存在確認）
  3. システムが請求の支払い状態を「支払い済み」に更新する
  4. システムが支払い完了を記録する（支払い日時、決済トランザクションID）

拡張（代替フロー） ​

  • 2a. 通知の検証に失敗した場合（不正な署名等）:

    1. システムが通知を破棄し、警告を記録する

  • 2b. 対象の請求が存在しない場合:

    1. システムが不一致を記録し、運用担当者に通知する

  • 3a. 支払い失敗の通知を受信した場合:

    1. システムが請求の支払い状態を「支払い失敗」に更新する
    2. 支払い失敗をアクターに通知する（代行管理者/企業管理者）

業務ルール ​

  • 入金通知の処理は冪等であること。同一トランザクションIDの二重処理を防止する
  • 支払い状態: 未払い → 支払い済み / 支払い失敗
  • 部分入金には対応しない。クレジットカード決済では請求全額を一括課金する
  • 支払い方法はクレジットカード決済を前提とする。対応決済手段の拡張は将来検討
  • 支払い失敗が発生した場合、外部決済サービス側でのリトライ（カード再請求）も考慮する

関連要件 ​