gate-exchange-pay

gate-cli の解決（バイナリパス）

gate-cli は次の順序で解決します。（1） command -v gate-cli と gate-cli --version が成功すること、（2） 実行可能な場合は ${HOME}/.local/bin/gate-cli、（3） 実行可能な場合は ${HOME}/.openclaw/skills/bin/gate-cli。正規のルールについては、exchange-runtime-rules.md §4 または gate-runtime-rules.md §4 を参照してください。

gate-exchange-pay — Gate Pay による決済

一般ルール

⚠️ 停止してください — 続行する前に、共有ランタイムルールを必ず読み、厳守してください。 すべてのルールを読み終えるまで、ツールを選択したり呼び出したりしないでください。これらのルールが最優先です。 → gate-runtime-rules.md を読んでください

• このスキルに明示的に記載されている gate-cli コマンドのみを使用してください。 ここに記載されていないコマンドは、ほかのインターフェースで利用可能であっても、このワークフローでは実行してはいけません。

対象範囲と対象者

このドキュメントはエンドユーザーとエージェントを対象としています。先に決済が必要な状況で、ユーザーがすでに決済方法を選択し、Gate Pay を選んでいる場合は、Exchange MCP ツール cex_pay_create_ai_order_pay を呼び出して請求を完了し、領収書を出力するためにこの機能を使用してください（gate-cli/cmd/cex に gate-cli の対応付けはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照してください）。

このスキルを呼び出す前に、ユーザーは Gate アカウントの決済関連の認可を完了している必要があります。未完了の場合は、請求を行う前に Gate アカウントの認可を完了するよう案内してください。

言語

領収書、請求前の概要、失敗時のメッセージ、短い確認にはユーザーの言語を使用してください。会話内で複数の言語が使われている場合は、決済または領収書に関するリクエストの言語に従ってください。ユーザーが言語を切り替えない限り、領収書は1つの言語で作成してください。

適用される場合

• ユーザーが決済の意思を明確に示している場合（例：支払う、決済を確定する、チェックアウト、代わりに支払って）。
• 先に決済が必要である場合（例：該当する場合、HTTP 402 または同等の先払い手順の後）、ユーザーが決済方法として Gate Pay を選択しており、別の決済手段に置き換えない場合。
• 決済呼び出しに必要な情報がすべてそろっており、cex_pay_create_ai_order_pay（gate-cli/cmd/cex に gate-cli の対応付けはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照してください）に必要なすべての引数が満たされている場合（MCP の inputSchema に従う）。不足がある場合は、決済前に補完してください。
• この機能は、402 を取得することだけを目的とした保護 URL への初回アクセスには対応しません。その処理は会話内のほかの箇所で行う場合があります。ユーザーが Gate Pay を選択し、決済に必要な情報がそろったら、この機能を使って請求してください。

適用されない場合

• ユーザーが大きな生の API テキストだけを貼り付け、決済に必要な情報を確実に特定できない場合 → 請求せず、注文ページまたはチェックアウトページで詳細を確認するようユーザーに依頼してください。
• 加盟店の検索、価格比較、ショッピングに関する案内 → 対象外です。
• Gate Pay を使った特定の加盟店注文への請求に関係のない、現物取引、契約取引、入金、オンチェーン送金 → この機能では扱わないでください。

ドメイン知識

Gate Pay の概要

Gate Pay は、ユーザーが Gate アカウントの残高を使って加盟店の注文を決済できる、Gate のデジタル資産決済ソリューションです。リソースへのアクセス前に決済が必要な先払いフロー（HTTP 402 プロトコル）に対応しています。

認可要件

• 請求を開始する前に、ユーザーは Gate アカウントの決済認可を完了する必要があります
• 認可には、決済アカウントからの引き落としに必要な認証と権限の付与が含まれます
• 認可がない、期限切れ、または無効の場合は、まず Gate アカウントの認可を完了するようユーザーに案内してください

決済フローの制約

• 決済は正常に実行されると取り消せません
• 決済を開始する前に、注文情報（order_id、amount、currency）がすべて揃っている必要があります
• このスキルが対応するのは請求処理のみです。加盟店からのリソース取得は対象外です
• 決済バウチャーのフィールド（返された場合）は後続のステップで使用できますが、捏造してはいけません

Gate Pay とその他の決済方法

• このスキルが対応するのは Gate Pay による決済のみです。その他の決済方法（銀行カード、他の暗号資産ウォレット）は対象外です
• このスキルを有効にする前に、ユーザーが決済方法として Gate Pay を明示的に選択する必要があります

gate-cli コマンド一覧

ツール名	用途	種別
cex_pay_create_ai_order_pay（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）	加盟店の注文に対して、ユーザーの Gate Pay 決済アカウントから引き落とします	書き込み

認証

• 対話形式のファイル設定： ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されていない場合は、gate-cli config init を実行し、ウィザードで API キー、シークレット、プロファイル、デフォルトを設定します（gate-cli を参照）。
• 環境変数／フラグ： 認証情報がすでに提供されている場合は、gate-cli config init は不要です。たとえば、ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されている場合、または対応している場合に --api-key ／ --api-secret を指定する場合です。シークレットをチャットに貼り付けるようユーザーに求めてはいけません。
• API キーが必要です：はい
• 追加の認証が必要です：はい。Gate Pay の決済認証が事前に完了している必要があります
• 注記：このスキルは、認証済みの Exchange MCP ツールを通じて非公開の決済処理を実行します。実行時の API キーに基づく実行機能に加えて、決済認証も必要です。

注記：注文ステータスを照会するツールがなく、ユーザーが支払い済みかどうかだけを尋ねている場合は、その制約を説明してください。照会の代わりに再度請求してはいけません。

インストール確認

• 必須： CLI を使用するフローでは gate-cli が必要です（見つからない場合は、このスキルのディレクトリから sh ./setup.sh を実行してください。GATE_CLI_SETUP_MODE=release は任意です）。
• gate-cli を名前で実行する場合は、$HOME/.openclaw/skills/bin（または setup.sh のインストール先ディレクトリ）を PATH に追加してください。
• 認証情報： ホストに GATE_API_KEY と GATE_API_SECRET の両方が空でない値で設定されている場合、gate-cli config init を必須にしてはいけません。両方が未設定または空の場合は、オペレーターに gate-cli config init を実行するか、スキルライブラリ内の対応するスキルで GATE_API_KEY ／ GATE_API_SECRET を設定するよう案内してください（シークレットをチャットに貼り付けるようユーザーに求めてはいけません）。
• 動作確認： 請求を実行する前に、実行環境と決済の前提条件を確認してください。必要に応じて gate-cli --version またはデプロイ環境固有の確認方法を使用してください。

実行モード

references/gate-cli.md を読み、厳密に従ってから、このスキルの Gate Pay 請求ワークフローを実行してください。

• SKILL.md は決済インテントのルーティング、製品の対象範囲、ユーザー向けポリシーを定めます。
• references/gate-cli.md は、請求入力、確認ゲート、失敗時のフォールバックに関する、正式な gate-cli 実行仕様です。

ワークフロー

ステップ 0：決済準備状況の確認

アクション：続行する前に、すべての前提条件が満たされていることを確認します。

抽出する主なデータ：

• ユーザーが決済方法として Gate Pay を選択している
• 必要な決済パラメーターがすべて揃っている：order_id、amount、currency
• ユーザーが Gate の決済認証を完了している（未完了の場合は停止し、認証方法を案内する）

判断：必要な入力が不足している場合 → 完全な情報を提供するようユーザーに尋ねます。認証が未完了の場合 → 認証フローを案内します。それ以外の場合はステップ 1 に進みます。

ステップ 1：ユーザーの支払い意思を確認する

操作：ユーザーが支払いを実行する意思を明確に示していることを確認します。

抽出する主なデータ：

• ユーザーが支払いの意思を示している（例：「支払う」「支払いを確定する」「チェックアウトする」「代わりに支払って」）
• ユーザーが支払いを拒否またはキャンセルしていない

判断：ユーザーの意思が不明確または否定的な場合は、支払いを実行しないでください。意思が明確な場合は、ステップ 2 に進みます。

ステップ 2：支払いの詳細を提示する（任意）

操作：ユーザーが確認できるよう、請求に関する主な詳細を表示します。これは情報提供を目的とするもので、明示的な確認を強制するステップではありません。ステップ 1 の代わりにはなりません。支払いツールを呼び出すには、そこで確認した明確な支払い意思が引き続き必要です（安全ルールを参照）。

抽出する主なデータ：

• 販売者の注文 ID
• 金額と通貨
• 支払い方法（Gate Pay）

出力形式：

Planned charge
Merchant order ID: {order_id}
Amount due: {amount} {currency}
Payment method: Gate Pay

判断：ステップ 1 の支払い意思に関する条件が満たされている場合、詳細の表示後にステップ 3 に進みます。任意の表示は透明性の確保のみを目的としています。

ステップ 3：支払いを実行する

操作：検証済みのパラメーターを使用して Exchange MCP ツール cex_pay_create_ai_order_pay（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）を呼び出します。

次の項目を指定して cex_pay_create_ai_order_pay（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）を呼び出します：

• order_id：販売者の注文識別子
• amount：支払い金額
• currency：支払い通貨
• MCP の inputSchema で定義されているその他の必須フィールド

抽出する主なデータ：

• 支払いステータス（成功／失敗）
• 取引のタイムスタンプ
• 支払い確認の詳細（order_id、amount、status）
• 後続処理に使用するバウチャーフィールド（該当する場合。例：prepayId）

判断：支払いが成功した場合は、成功レシートを添えてステップ 4 に進みます。支払いが失敗した場合は、失敗時の対応を行うためステップ 4 に進みます。

ステップ 4：結果を出力する

操作：ユーザーの言語で支払い結果を報告します（「言語」セクションを参照）。

成功時：「レポートテンプレート」セクションの形式に従ってレシートを出力します。

失敗時：内部エラーコードやスタックトレースを公開せず、ユーザーにわかりやすいエラーの説明を提供します（「エラー処理」セクションを参照）。

判定ロジックの概要

条件	ステータス	意味
支払いに必要な情報がすべて揃っている ＋ ユーザーが Gate Pay を選択している ＋ ユーザーの支払い意思が明確 ＋ 認証が有効	実行	cex_pay_create_ai_order_pay（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）を使用して支払いを実行します
order_id、amount、currency のいずれかが不足している	ブロック	販売者の注文ページで確認できる、支払いに必要な情報をすべて提供するようユーザーに依頼します
ユーザーが Gate Pay を選択していない	ブロック	このスキルの適用対象外です。その他の支払い方法は対象外です
ユーザーの意思が不明確、またはユーザーが拒否している	ブロック	支払いを開始せず、明確な確認を待つか、キャンセル処理を行います
認証がない、期限切れ、または無効	ブロック	先に Gate アカウントの支払い認証を完了するようユーザーに案内します
ユーザーが支払いステータスのみを尋ねている（照会ツールが利用できない）	情報提供	制限について説明します。ステータスを推測するために再請求してはいけません
支払い API が成功を返す	報告	取引の詳細を含む成功レシートを、ユーザーの言語に合わせて出力します
支払い API が失敗を返す	報告	実行可能な案内を添えて、ユーザーの言語で失敗の説明を出力します

レポートテンプレート

成功レシート

フィールドのラベルにはユーザーの言語を使用します（「言語」セクションを参照）。テンプレートの形式（英語のラベルは参考用です）：

✅ Payment Success

Merchant order ID: {order_id}
Amount paid: {amount} {currency}
Payment status: {status_text_matching_payment_result}
Payment time: {timestamp; include timezone or follow product rules}
Payment method: Gate Pay

⚠️ Important: Digital asset transactions are generally irreversible. Please verify the transaction details above.

バウチャーの取り扱い：支払い成功のレスポンスにバウチャー形式のフィールド（仕様で定義されている正式な名前。例：prepayId）が含まれる場合、後続の処理でそれらを使用して販売者からリソースを取得できます。このスキルではリソースを取得しません。該当する場合、バウチャーフィールドは外部で使用できるよう保持してください。

エラーの説明

ユーザーの言語を使用します（「言語」セクションを参照）。エラーの種類に応じて、具体的で実行可能な案内を提供します。

テンプレート：

❌ Payment Failed

Reason: {user_friendly_explanation}
Suggested action: {actionable_next_step}

禁止事項：内部エラーコード、スタックトレース、生の API レスポンスをユーザーに公開しないでください。

実行時のルール

決済関連のツールを呼び出す前に、この製品に付属するエージェントおよび MCP の使用ルールに従い、exchange-runtime-rules.mdを遵守してください。

シナリオ

レビュー担当者向けのシナリオテンプレート（正常系、エラー、ローカライズ、安全性の境界）は、このスキルディレクトリのreferences/scenarios.mdにあります。このファイルは、この SKILL との整合性チェックに使用してください。Skills Hub のハイパーリンクとして扱わないでください。

エラー処理

エラーの種類	条件	ユーザーへのメッセージ（テンプレート）	推奨される対応
残高不足	決済 API が残高不足エラーを返す	"決済に失敗しました：Gate Pay の残高がこの決済に対して不足しています。アカウントに入金して、もう一度お試しください。"	ユーザーに入金するか、別の決済方法を使うよう案内します
認証の期限切れ／無効	API が認証の未設定、期限切れ、または無効を示す	"決済に失敗しました：Gate の決済認証の期限が切れているか、無効です。Gate アカウントの認証をもう一度完了してください。"	Gate アカウントの決済認証フローをユーザーに案内します
注文が見つからない	API がorder_idが存在しない、または見つからないことを示す	"決済に失敗しました：注文 ID が無効であるか、すでに有効ではありません。販売者に注文の詳細を確認してから、もう一度お試しください。"	販売者から有効な注文情報を入手するようユーザーに依頼します
注文の期限切れ	API が注文の期限切れ、または決済可能時間の終了を示す	"決済に失敗しました：この注文は期限切れのため、決済できません。販売者に新しい注文を依頼してください。"	新しい注文を作成するか、販売者に代替注文を問い合わせるよう提案します
重複決済	業務ロジックが同一注文に対する重複請求の試行を検出する	"この注文はすでに決済済みです。決済履歴を確認してください。誤りと思われる場合は、サポートにお問い合わせください。"	重複請求を開始せず、その制限について説明します
無効なパラメーター	必須フィールドが欠落しているか、形式が無効	"決済を処理できません：必須情報の一部が欠落しているか、無効です。注文の詳細（注文 ID、金額、通貨）をすべて入力してください。"	完全で有効な決済パラメーターをユーザーに入力してもらいます
ネットワーク／システムエラー	API のタイムアウト、接続失敗、または不明なシステムエラー	"一時的なシステムの問題により決済に失敗しました。しばらくしてからもう一度お試しください。問題が解決しない場合は、サポートにお問い合わせください。"	後でもう一度試すよう提案し、技術的なエラーの詳細は公開しません

一般的なルール：

• すべてのエラーメッセージでユーザーの言語を使用します（「言語」セクションを参照）
• 内部エラーコード、スタックトレース、生の API レスポンスを公開しないでください
• 各エラーの種類に応じて、実行可能な次の手順を提示します
• エラーの種類が不明な場合は、再試行するかサポートに問い合わせるよう、中立的に案内します

データのプライバシーと収集

このスキルは、Gate MCP を通じてユーザーの決済データを処理します。すべてのデータは、決済を実行するために Gate API へ直接送信されます。

データの取り扱いに関する声明：

• データ収集：このスキルは、決済の実行に必要な注文情報（注文 ID、金額、通貨）とユーザーの決済認証情報を収集します
• データ保存：このスキルはユーザーデータをローカルに保存しません。すべての決済取引は Gate の安全な決済インフラストラクチャによって処理、記録されます
• データ送信：決済データは Gate API エンドポイントにのみ送信されます。サードパーティのサービスは関与しません
• データ保護：すべてのデータ送信には、Gate のセキュリティ基準に準拠した暗号化チャネルが使用されます
• ユーザーによる管理：ユーザーは Gate の公式プラットフォームから決済履歴を確認できます。取引記録は Gate のデータ保持ポリシーに従って保管されます

年齢制限：このスキルの対象は、Gate のプラットフォーム要件に従い、完全な民事行為能力を有する 18 歳以上のユーザーです。

リスクに関する免責事項

⚠️ Gate Pay ユーザーへの重要なお知らせ：

1. 損失のリスク：デジタル資産による決済には金銭的なリスクが伴います。注文内容や加盟店の情報に誤りがある場合、引き落とされた金額を失う可能性があります。請求を承認する前に、すべての詳細を確認してください。

2. 取引の不可逆性：デジタル資産の取引は、一般に取り消せません。Gate Pay による決済が正常に実行されると、元に戻すことはできません。決済を確定する前に、注文の詳細（加盟店、金額、通貨）をすべて慎重に確認してください。

3. 投資助言ではありません：このスキルは決済実行機能のみを提供します。決済に関する判断は、すべてユーザー自身の責任です。これは、投資、金融、税務、または法律に関する助言ではありません。

4. 規制の遵守：ユーザーは、Gate Pay の利用が自身の管轄地域で適用される法律や規制に準拠していることを確認する必要があります。Gate は複数の管轄地域でライセンスに基づいて事業を運営しています。現地の決済およびデジタル資産に関する規制を理解し、遵守する責任はユーザーにあります。

5. 加盟店の責任：Gate Pay は、サードパーティの加盟店への決済を仲介します。Gate は、加盟店の商品、サービス、配送、返金、または紛争について責任を負いません。ユーザーは、決済を行う前に加盟店の信頼性を確認してください。

6. AI の出力に関する免責事項：AI を活用した決済処理は利便性のためのものであり、決済の成功、加盟店の信頼性、または取引結果について、Gate が表明、保証、または確約するものではありません。

安全上のルール

確認要件

このスキルは、決済実行にあたり、簡素化された確認モデルに従います。

1. ユーザーの意思確認：ユーザーは決済の意思を明確に示す必要があります（例：「支払う」、「決済を確定する」、「チェックアウト」）
2. パラメーターの確認：決済の詳細（注文 ID、金額、通貨）をユーザーが確認できるように表示する場合がありますが、明確な決済意思の表明に加えて、強制的な確認手順は必要ありません
3. 確認の使い切り：決済の意思確認は一度限り有効です。パラメーターまたは加盟店の詳細が変更された場合は、意思を再確認する必要があります
4. 意思確認なしでの実行禁止：ユーザーの決済意思が明確でない場合、このスキルは照会／情報提供モードでのみ動作します

認証ガード

• 実行前チェック：cex_pay_create_ai_order_pay を呼び出す前に（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）、ユーザーが Gate の決済認証を完了していることを確認してください
• 認証の検証：認証が存在しない、有効期限切れ、または無効の場合は、決済を停止し、認証フローを案内してください
• 回避の禁止：いかなる状況でも、決済の実行で認証要件を回避してはなりません

二重決済の防止

• 取引の追跡：会話のコンテキスト内で、同じ order_id に対して二重に請求しないでください
• ステータス照会の制限：ユーザーから「支払いは済んでいますか？」と尋ねられた場合、ステータスを推測するために二重に請求するのではなく、照会できない旨を説明してください

セキュリティ要件

1. 注文情報、支払いステータス、タイムスタンプ、支払いバウチャーを捏造しないでください。
2. 入力が不完全な場合、またはユーザーがこの支払いに Gate Pay を選択していない場合は、請求を開始しないでください。
3. 請求が成功しなかった場合、成功を示す領収書を出力したり、支払いが成功したと主張したりしないでください。
4. 同じ取引に対して二重に請求しないでください。
5. 決済 API から返されなかったバウチャーの項目を捏造しないでください。
6. API キー、内部エラーコード、システムアーキテクチャの詳細などの機密データを、ユーザー向けメッセージに記載しないでください。
7. インジェクション攻撃や不正な形式のデータによる攻撃を防ぐため、決済 API を呼び出す前にすべての入力パラメーターを検証してください。