ゼウス決済 — 接続設定

ゼウス回答・MIT/API・月次運用の正本はリポジトリ内 10_説明書/ZEUS_RULES.md です（重複質問防止・実装状態の一覧）。

0. いまできること・できないこと（2026-06 時点）

HWYS だけで完結するのは着手金の Link Point まで。振替 NG 時の再入力なし請求はゼウス売上管理の継続予約（人手）。HWYS からの自動 MIT 請求は未実装。

やりたいこと	状態	どうやる	お客様
着手金（税込110,000円）	○ HWYS	ポータル → Link Point	カード入力・3-D
sendid へカード登録	○ HWYS	着手金と同時	同上
決済履歴の確認	○ HWYS	運営「決済・お支払い」タブ	—
振替 OK/NG 確認	△ ゼウス手動	ゼウス売上管理（+4営業日後）	—
振替 NG → カード請求（再入力なし）	△ ゼウス手動	継続予約登録（15時以降）	不要
振替 NG → HWYS から自動請求	× 未実装	API 機能解放＋開発待ち	不要（予定）
返金・取消	△ ゼウス手動	ゼウス売上管理のみ	—
振替結果の HWYS 自動取込	× 不可	ゼウス回答: 自動連携なし	—

詳細・誤解しやすい点は 10_説明書/ZEUS_RULES.md 文頭の一覧を参照。

管理画面に「API」という名称のメニューが無い場合が多いです。Link Point 連携に必要なのは IPコード と 認証キー です（URL決済 API を別契約する場合は追加仕様書が必要）。

1. IPコード・認証キーの確認

ゼウス売上管理画面にログイン
左メニュー 「各種設定」 ブロック内の 「設定情報確認」 を開く
利用する IPコード（5〜10桁の数字）を選択し 「表示」
IPコード と 認証キー を控える（画面にコピー）

参考：システム設定マニュアル（ゼウスサポート） — リンク型 / URL決済API型の PDF リンクあり（ログイン後ダウンロード可）。

2. ゼウス設定（config.php に保存）

ゼウス売上管理画面の 設定情報確認 で控えた値を入力し、保存してください。FTP での編集は不要です。

3. ゼウス管理画面側の URL 登録（Link Point）

ゼウス担当または管理画面のシステム設定で、次の URL を登録依頼してください。

戻り URL — 千田様より 2026-06-20 登録完了の連絡あり（portal_zeus_return.php）。CGI は引き続き管理画面でご確認ください。

決済完了・失敗の戻り先（success / failure）: https://tyuoukanri.hwysgroup.com/portal_zeus_return.php
CGI コールバック（サーバー間通知）: https://tyuoukanri.hwysgroup.com/zeus_notify.php

sendid には公開ID（14桁数字＝ゼウス顧客番号）を渡します。移行: 公開ID 14桁移行

4. 現在の設定状態

enabled: ON
clientip: 設定済（末尾 391）
auth_key: 設定済
test_mode: テスト
Link POST 先: https://linkpt.cardservice.co.jp/cgi-bin/order.cgi?orders
着手金（税込）: 110,000 円

5. DB マイグレーション

決済履歴テーブル client_zeus_orders が必要です。

apply_pending_migrations（026 含む）

6. 売上管理画面ログインについて

加盟店ID / パスワード（Webログイン用）があれば、あなたがゼウス管理画面を操作できます。IPコード・認証キーとは別物です。

IPコード + 認証キー → HWYS CENTRAL の config.php（決済連携用）
加盟店ID + パスワード → 売上管理画面ログイン（日常の確認・手動請求用）

AI（Cursor）が管理画面を代わりに見ることはできません。チェックリストはあなたがログインして確認してください。

7. 確認チェックリスト（売上管理画面での場所）

メニュー名は契約プランで多少異なります。見つからない場合はゼウスサポートへ。

確認項目	管理画面での目安	HWYS CENTRAL との関係
Link Point / sendid	各種設定 → 設定情報確認（接続方式 LinkPoint の表示）または各種設定 → システム設定	sendid = 公開ID（14桁）。Link POST 連携
IPコード・認証キー	各種設定 → 設定情報確認 → IP選択 → 表示	`config.php` の zeus.clientip / auth_key
CGI / 戻り URL	各種設定 → システム設定（CGI送信先・完了URL）未設定ならゼウス担当へ依頼	`https://tyuoukanri.hwysgroup.com/portal_zeus_return.php` `https://tyuoukanri.hwysgroup.com/zeus_notify.php`
カード登録（sendid 紐づけ）	初回決済後 → 売上照会 / 会員・カード管理（名称はプラン次第）で sendid 検索	着手金決済後に登録されているか確認
初回 Link Point（QuickCharge）	初回は sendid のみでカード登録可（ゼウス回答 A-2）	QuickCharge 別パラメータは不要。着手金 POST は実装済み
カードID継続決済 API	各種設定 → マニュアル PDF（カードID継続決済）利用前に契約・機能解放が必要（ゼウス回答 B-2）	振替 NG 時のサーバー請求（MIT）。未実装 — 解放後に開発
手動再請求（継続予約）	売上管理の継続予約登録等（ゼウス回答 B-1）登録日 15時以降に決済（B-5）	API 完成前の運用。金額・月は都度変更可（B-4）
口座振替結果（アプラス）	売上管理画面で結果確認（ゼウス回答 D-2）ゼウス↔アプラス自動連携はなし（D-1）	NG 検知は人手 → 手動請求または将来 API
仕様書 PDF	各種設定 → システム設定マニュアルまたはサポートページ	Link Point / カードID API の詳細

8. URL決済 API について

2026年以降、メール／チャット用の URL決済 API が提供されています。HWYS CENTRAL では Link Point（着手金・3-Dセキュア + カード登録） を採用しています。

9. ゼウス回答サマリー（照合済み）

株式会社ゼウス千田様への確認事項に対する回答（社内照合日: 2026-06）。詳細・重複質問禁止リストは 10_説明書/ZEUS_RULES.md を正本とする。

区分	要点	HWYS の状態
A 初回	sendid（14桁）でカード登録可。QuickCharge 不要。初回 3-D 必須で可。	Link Point 実装済み
B 再請求	管理画面の継続予約登録またはカードID継続決済 API。API は機能解放が必要。MIT は初回3-D＋カードID利用が条件。	API 未実装。手動運用可
C 技術	POST 項目（clientip 等）は現行で可。戻りURL＋CGI 両方可。	return + zeus_notify 実装済み
C テスト	テスト環境は別途申込。申込書送付後 → テストIPで検証 → URL 本番切替。	申込書返送待ち
D 振替	アプラス失敗のゼウス自動連携なし。結果は売上管理画面で確認。	月次確認フロー要運用
E 運用	着手金カード＋月額振替＋NG時カードは問題なし。マニュアル: system.html	契約・特商法と一致

10. カードID継続決済 API — 実装タスク（機能解放後）

ゼウス側でカードID継続決済が有効化されたあと、HWYS CENTRAL で進める作業一覧です。

仕様取得 — 売上管理の PDF（カードID継続決済）を入手。POST 先・必須項目・成功/失敗コードを整理。
config 拡張 — API 用エンドポイント・店舗識別子（要否）を config.php の zeus セクションに追加。
サーバー請求関数 — lib/zeus_payment.php に「sendid + 金額 + sendpoint」で POST する hwys_zeus_charge_registered_card() を新設。
運営 UI — 顧客メタ（ヒアリング）のゼウスパネルから「振替NG分をカード請求」ボタン（金額プレビュー・確認ダイアログ）。
履歴 — client_zeus_orders に kind=mit_repayment 等で記録。監査ログ連携。
顧客ポータル — 再決済 Link Point ボタンは、MIT 運用確定後は非表示または運営専用に整理（再入力・3-D 回避のため）。
テスト — テスト IP で初回 Link Point → sendid 登録 → API 請求の一連を検証。
本番 — test_mode=false、CGI/戻り URL 本番登録、運用手順（振替 NG 確認 → 請求）を社内文書化。

短期運用: テスト環境準備までの間、振替 NG は売上管理の継続予約登録（15時以降ルール）で対応可。

11. テスト環境申込〜本番切替

ゼウスから届くテスト環境申込書に記載し返送
テスト用 IP コードで config.php を設定（test_mode => true）
Link POST 先が order.cgi?orders であることを確認（§4）
着手金のテスト決済（3-D）→ sendid でカード登録されているか売上管理で確認
CGI（zeus_notify.php）・戻り URL をゼウスに登録済みか確認
問題なければ test_mode => false、clientip を本番 IP に切替（Link POST 先は同じ order.cgi?orders）

12. 千田様宛メール文案（コピー用）

Gmail・Outlook 等のメール作成画面にそのまま貼り付けできるプレーンテキストです。件名と本文を分けて表示しています。

件名

Re: テスト環境のご案内・Link Point接続結果およびカードID継続決済APIについて（HWYS株式会社）

本文

株式会社ゼウス
千田 様

お世話になっております。
HWYS株式会社 代表の木村です。

先日はテスト環境のご案内ならびに、Link Point連携に関する
ご回答をいただき、誠にありがとうございました。
その後、弊社側で接続検証を進めましたので、
結果と今後のご相談事項をご報告申し上げます。


■ 1. Link Point（着手金）テスト結果

テスト環境（IPコード：2019002391）にて、
Link Pointによる着手金決済の接続テストを実施し、
正常に完了いたしました。

  ・決済方式：Link Point（画面遷移型・3-Dセキュア）
  ・金額：税込110,000円（着手金）
  ・会員番号：sendid（弊社発行の14桁顧客番号）
  ・結果：決済成功を確認
  ・弊社システム：決済結果を自社管理画面（HWYS CENTRAL）に記録

初回決済時にsendidへカード情報が登録される想定どおりの
動作でした。ご案内いただいた内容（sendidのみで可・
初回3-D必須）と整合していることを確認しております。


■ 2. 弊社システム（HWYS CENTRAL）での決済管理の考え方

ゼウス売上管理画面に代わるものではなく、
顧客ごとの決済状況を弊社が一覧で把握・運用するための
自社管理画面を構築しております。

  【HWYS CENTRAL（弊社）】
    顧客別の決済成功/失敗の記録
    着手金・再決済履歴
    月次の振替結果メモ
    請求操作の起点

  【ゼウス売上管理（御社）】
    全体売上の照合、返金・取消
    会員（sendid）確認
    口座振替結果の公式確認

Link Pointによる決済の発行と、結果の自社記録までは
実装済みです。今後、月次の口座振替運用を
この画面に統合したいと考えております。


■ 3. 月次運用のイメージ（ご相談の背景）

弊社サービスの請求体系は次のとおりです。

  ・契約時：着手金（税込110,000円）…クレジットカード（Link Point）※テスト済
  ・毎月27日：月額利用料（税別15,000円）…口座振替（アプラス経由）
  ・振替不能時：月額＋再決済手数料（税別500円）…税込17,050円
    …初回登録済みカードへの請求

毎月の運用フローは、次のイメージです。

  (1) 毎月27日：口座振替
  (2) 振替結果通知後（4営業日後）：ゼウス売上管理画面でOK/NGを確認
  (3) NGの場合：弊社管理画面で「カード請求」を実行し、顧客へメール通知
  (4) 請求結果を弊社管理画面に記録

ご以前ご回答いただいたとおり、アプラス振替結果の
ゼウス自動連携はないとの理解です。
そのため、振替結果の確認はゼウス売上管理で行い、
NG時のカード請求はHWYS CENTRALから操作する形を
想定しております。


■ 4. ご相談・ご確認いただきたい事項

前回ご回答いただいた内容（B-1〜B-3）を踏まえ、
「再入力なし・MITでの請求が可能か」という点は
理解済みです。以下は、実装・運用に向けた
追加のご確認事項です。

【A】カードID継続決済API — 機能解放の手続き

前回B-2にて「契約・機能解放が必要」と
ご回答いただいております。

  A-1. 機能解放手続きを進めるため、
       弊社側で提出・記載すべき書類や申込内容を
       ご教示ください。

  A-2. 機能解放後、API仕様書（PDF）を
       ご提供いただけますでしょうか。
       （POST先URL、必須パラメータ、成功/失敗コード、
       CGI通知の有無 等）

  A-3. テスト環境（IPコード2019002391）でも、
       機能解放後はAPI請求のテストが可能でしょうか。


【B】API実装に向けた技術確認（前回回答の具体化）

前回ご回答のとおり、初回Link Point（3-Dセキュア済）で
sendidへカード登録後、MIT（3-D不要）での請求が
可能との理解です。HWYS CENTRALからの自動請求実装に
あたり、以下をご確認ください。

  B-1. 振替NG分（税込17,050円）を、
       カードID継続決済APIで請求する流れで
       問題ないでしょうか。

  B-2. API請求の際、sendid・金額・sendpoint
       （弊社側の取引ID）をPOSTする形でよいでしょうか。
       他に必須の項目があればご教示ください。


【C】CGI・戻りURLの確定

テスト決済にあたり、弊社側では次のURLを使用しております。

  CGI（サーバー間通知）：
  https://tyuoukanri.hwysgroup.com/zeus_notify.php

  戻りURL（決済完了後）：
  https://tyuoukanri.hwysgroup.com/portal_zeus_return.php

暫定登録の https://hwysgroup.com/ から、
上記への変更登録をお願いできますでしょうか。


【D】口座振替結果について（参考）

  D-1. 振替結果（OK/NG）を、CSVダウンロード等で
       定期的に取得する方法があれば、
       弊社管理画面への取り込みを検討したいです。
       自動連携が難しい場合、運用手順のご案内だけでも
       結構です。


■ 5. 当面の運用（API完成前）

API機能解放までの間は、ご回答いただいた
売上管理画面の「継続予約登録」（15時以降ルール）で
対応する想定です。
並行して、弊社管理画面側では
「振替NG → 手動請求 → 記録 → 顧客通知」の
運用フローを整備してまいります。


お忙しいところ恐れ入りますが、
特に【A】カードID継続決済APIの機能解放と
【C】CGI・戻りURLの変更について、
ご確認・ご対応いただけますと幸いです。

ご不明点がございましたら、お気軽にお申し付けください。
引き続き、どうぞよろしくお願い申し上げます。


HWYS株式会社
代表取締役　木村 晴輝
haruki_kimura@hwysgroup.com

顧客一覧へ · 環境チェック