接続設定

ゼウス接続

着手金は Link Point。振替 NG のカード請求は決済デスク／月次オペのボタン（テスト IP では本番売上になりません）。詳細は説明書を参照。

いまできること

振替 NG は振替チェック（経営状況 → 経営データ）または決済デスクのカードタブから請求できます。口座依頼は口座依頼書の一覧。

やりたいこと	状態	どうやる	お客様
着手金（税込110,000円）	○ HWYS	ポータル → Link Point	カード入力・3-D
sendid へカード登録	○ HWYS	着手金と同時	同上
決済履歴の確認	○ HWYS	運営「決済・お支払い」タブ	—
振替 OK/NG 確認	△ ゼウス手動	ゼウス売上管理（+4営業日後）	—
振替 NG → カード請求（再入力なし）	○ HWYS	決済デスク／月次オペの請求ボタン。失敗時は継続予約登録（15時以降）	不要
振替 NG → HWYS から自動請求	△ テスト IP	SecureLinkBatch（実装済）。本番 IP の解放はテスト成功後に依頼	不要
返金・取消	△ ゼウス手動	ゼウス売上管理のみ	—
振替結果の HWYS 自動取込	× 不可	ゼウス回答: 自動連携なし	—

詳細は 10_説明書/ZEUS_RULES.md。

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継続決済）審査・追加費用なし。テスト IP は受け入れ可能（千田様 2026-08）	振替 NG 時のサーバー請求（MIT）。実装済（決済デスク／月次オペ）。テスト IP の試験 POST は未実施
手動再請求（継続予約）	売上管理の継続予約登録等（ゼウス回答 B-1）登録日 15時以降に決済（B-5）	API 失敗時の代替。金額・月は都度変更可（B-4）
口座振替結果（アプラス）	売上管理画面で結果確認（ゼウス回答 D-2）ゼウス↔アプラス自動連携はなし（D-1）	NG 検知は人手 → 決済デスク／月次オペの請求ボタン、または継続予約
仕様書 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。審査・追加費用なし。テスト IP は SecureLinkBatch 受け入れ可能（2026-08）。	API 実装済（決済デスク／月次オペ）。テスト IP の試験 POST は未実施。失敗時は手動の継続予約
C 技術	POST 項目（clientip 等）は現行で可。戻りURL＋CGI 両方可。	return + zeus_notify 実装済み
C テスト	テスト IP `2019002391`。Link Point テスト成功済。SecureLinkBatch 受け入れ可能（千田様 2026-08）。	API 試験 POST は未実施
D 振替	アプラス失敗のゼウス自動連携なし。結果は売上管理画面で確認。	月次確認フロー要運用
E 運用	着手金カード＋月額振替＋NG時カードは問題なし。マニュアル: system.html	契約・特商法と一致

10. カードID継続決済 API — 実装状況

HWYS CENTRAL 側の請求関数と運営ボタンは実装済みです。ゼウス側テスト環境（IP 2019002391）は SecureLinkBatch 受け入れ可能。残作業は着手金済み sendid での試験 POSTと、成功後の本番 IP 解放依頼です。

仕様 — 社内 PDF（カードID継続決済）。POST 先 secure.cgi。
config — batch_endpoint（空なら既定の secure.cgi）。
サーバー請求 — hwys_zeus_charge_registered_card()（sendid + 金額 + sendpoint）。
運営 UI — 決済デスク「カード決済」タブ／振替チェックの NG 行。
履歴 — client_zeus_orders.kind=mit_repayment。監査ログ連携。
顧客ポータル — 再決済 Link Point は非公開のまま（再入力・3-D 回避）。
テスト — テスト IP で初回 Link Point → sendid 登録 → API 請求。コードからの自動実 POST はしない。
本番 IP — 試験成功後に 2014012080 の SecureLinkBatch 解放を依頼（いまは切替しない）。

API が失敗したときは、売上管理の継続予約登録（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円）…口座振替（アプラス経由）
  ・振替不能時：月額費用 15,000円（税 1,500円）、再決済手数料 500円（税 50円）、税込合計 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

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