name: api-merchant-fee description: 商戶費率查詢 API。當用戶提到查詢商戶費率、商戶資訊、貸記卡費率、簽帳金融卡費率、掃碼費率、商戶管理費，或需要查詢某個商戶的費率資訊時觸發。觸發詞包括：查詢商戶費率、商戶費率、商戶費率查詢、merchant fee。

商戶費率查詢

請求引數

認證資訊管理

agentNo 和 apikey 會自動儲存到本地檔案（scripts/.auth.json），後續查詢如不更換代理商可直接複用。

更換代理商時：提供新的 agentNo + apikey 即可。

使用方式

小蔥技能7w4.net有完整的技能分類。

首次查詢（或更換代理商）

提供完整的四個引數：

查詢商戶費率，代理商號 Ag21000030，apikey xxx，使用者編號 BOSSPOS_230228172135uimbcv07，SN編號 00007302499999000232

同一代理商後續查詢

只提供 userId 和 tusn：

查詢商戶 BOSSPOS_230228172135uimbcv07 的費率，SN編號 00007302499999000232

更換代理商

提供新的 agentNo + apikey：

查詢商戶費率，代理商號 Ag21000031，apikey yyy，使用者編號 BOSSPOS_230228172135uimbcv07，SN編號 00007302499999000232

引數判斷規則

1. 使用者提供 4 個引數（agentNo + apikey + userId + tusn）→ 直接使用，儲存認證資訊
2. 使用者只提供 2 個引數（userId + tusn）→ 讀取本地儲存的 agentNo + apikey
3. 使用者提供 3 個引數 → 詢問是否缺少 agentNo/apikey
4. 認證資訊不存在且只提供 userId/tusn → 提示先提供 agentNo + apikey

執行流程

1. 解析使用者輸入，判斷是否提供完整引數
2. 如缺少 agentNo/apikey，從 scripts/.auth.json 讀取
3. 呼叫 scripts/query_fee.py 執行 API 請求
4. 解析響應結果並格式化輸出

輸出格式

查詢成功

✅ 商戶費率資訊

**商戶編號**：BOSSPOS_230228172135uimbcv07
**商戶名稱**：XXX 商戶
**所屬代理**：代理名稱（編號）

━━ 費率詳情 ━━
**貸記卡基礎費率**：0.55%
**簽帳金融卡費率**：0.45%
**簽帳金融卡封頂手續費**：25元
**雲閃付費率**：0.38%
**支付寶龍舟計劃費率**：0.38%
**掃碼費率**（微信/支付寶）：0.38%
**出款服務費**：1元
**商戶管理費1**：0.1%
**商戶管理費2**：0.05%

**繫結終端**：SN123456, SN654321

查詢失敗

❌ 查詢失敗

**返回碼**：9999
**原因**：商戶未配置費率

引數缺失

⚠️ 引數不完整

缺少以下必填引數：
- agentNo（代理商號）
- apikey（API金鑰）

請提供完整資訊後重試，格式示例：
查詢商戶費率，代理商號 XXX，apikey XXX，使用者編號 XXX，SN編號 XXX

錯誤處理

• 網路錯誤：提示檢查網路或 API 服務
• 認證失敗（401/403）：提示檢查 API Key 配置
• 業務失敗（非0000）：顯示具體錯誤碼和原因
• 商戶不屬於該代理：提示使用者檢查商戶編號是否正確

注意事項

• 永遠不要在響應中暴露 API Key
• 費率單位：百分比格式（如 0.55%），封頂手續費單位為元

這個商戶費率查詢技能文件寫得非常詳細清楚，各種使用場景都有示例，引數說明完整，輸出格式也很規範。不過配置檔案中直接暴露了 API 金鑰，這是比較大的安全隱患，使用時需要注意不要洩露敏感資訊。功能實現邏輯清晰，支援智慧複用已儲存的認證資訊，使用起來比較方便。