組織が支払い用のクレジットカードを登録する機能。決済代行 Mulpay(GMOマルチペイメント)を用い、3Dセキュアでカードを登録する。
組織管理者が支払い用クレジットカードを登録する機能。決済代行サービス Mulpay(GMOマルチペイメント)の API クライアント
(@aihomestaging/mulpay)を通じて、カードのトークン化・3Dセキュア認証を経て登録する。
/payment/credit-card)。createCardToken でカードをトークン化。memberInquiry(organizationId) で会員を確認。無ければ saveMember(会員=組織)を作成。entryTran で取引を開始し、3Dセキュアのリダイレクト情報(memberId / accessId / accessPass / redirectUrl)を取得。/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 — 組織の登録済みカードを閲覧packages/mulpay(access-token / member / card / entry-tran / exec-tran / secure-tran-2(3DS) / save-member / search-card / search-recurring 等)apps/{organization-manager,system-manager}/lib/mulpay/index.ts(環境変数: siteId/sitePass/shopId/shopPass/token認証キー等)apps/organization-manager/app/payment/credit-card/_components/credit-card-save-form/_actions/create-3ds-secure-redirect-data.tsapps/organization-manager/app/payment/credit-card/callback/_components/result-checker/_actions/finish-3d-secure.tsapps/system-manager/app/organizations/[organizationId]/_components/payment-view/_actions/get-card.ts本ドキュメントは既存実装をもとに遡及作成。今後の改修は sessions/ 配下に追記する。