決済機能(Payment / Mulpay)

組織が支払い用のクレジットカードを登録する機能。決済代行 Mulpay(GMOマルチペイメント)を用い、3Dセキュアでカードを登録する。

組織管理画面(登録) システム管理画面(閲覧) Mulpay / 3Dセキュア 課金実行は未実装

概要

組織管理者が支払い用クレジットカードを登録する機能。決済代行サービス Mulpay(GMOマルチペイメント)の API クライアント (@aihomestaging/mulpay)を通じて、カードのトークン化・3Dセキュア認証を経て登録する。

カード登録フロー(3Dセキュア)

  1. 組織管理者がカード情報を入力(/payment/credit-card)。
  2. createCardToken でカードをトークン化。
  3. memberInquiry(organizationId) で会員を確認。無ければ saveMember(会員=組織)を作成。
  4. entryTran で取引を開始し、3Dセキュアのリダイレクト情報(memberId / accessId / accessPass / redirectUrl)を取得。
  5. カード会社の3Dセキュア認証ページへリダイレクト。
  6. 認証後、コールバック(/payment/credit-card/callback)で finish-3d-secure を実行し、カード登録を確定。

関連する画面

組織管理画面(apps/organization-manager)— カード登録

  • /payment/payment/credit-card にリダイレクト — カード入力・登録(3DS開始)
  • /payment/credit-card/callback — 3DS認証結果の確認・確定

※ 現状、組織管理画面ヘッダーの「決済」ナビはコメントアウトされており、画面は存在するが導線が未公開(直接URLでのみ到達)。

システム管理画面(apps/system-manager)— カード閲覧

  • /organizations/[organizationId]/payment — 組織の登録済みカードを閲覧

主要な実装(参照)

関連・未実装

開発セッション履歴

本ドキュメントは既存実装をもとに遡及作成。今後の改修は sessions/ 配下に追記する。