oen-payment-mcp-server

  ___               ____                                  _  ⚡️⚡️
 / _ \  ___ _ __   |  _ \ __ _ _   _ _ __ ___   ___ _ __ | |_ ⚡️
| | | |/ _ \ '_ \  | |_) / _` | | | | '_ ` _ \ / _ \ '_ \| __|
| |_| |  __/ | | | |  __/ (_| | |_| | | | | | |  __/ | | | |_ 
 \___/ \___|_| |_| |_|   \__,_|\__, |_| |_| |_|\___|_| |_|\__|
                               |___/                          
 __  __  ____ ____    ____                                    
|  \/  |/ ___|  _ \  / ___|  ___ _ ____   _____ _ __          
| |\/| | |   | |_) | \___ \ / _ \ '__\ \ / / _ \ '__|         
| |  | | |___|  __/   ___) |  __/ |   \ V /  __/ |            
|_|  |_|\____|_|     |____/ \___|_|    \_/ \___|


 您的友善支付助手
 應援金流整合的 Model Context Protocol (MCP) 伺服器 (Alpha Version)

🍌 功能特色

💳 支付連結生成 - 建立付款結帳頁面
🔄 訂閱服務管理 - 處理定期定額付款
📊 交易查詢 - 查詢付款狀態與歷史紀錄
📋 完整文檔 - 內建 API 技術文件

🍌 使用方式

在確認您的應援金流測試商戶已經開啟後，請依據以下方式(擇一)進行配置

本地 MCP 伺服器設置
一鍵安裝 (Claude 用戶專用)

🍌 本地 MCP 伺服器設置

前置需求：

Node.js >=22.14.0 (建議使用 nvm 管理您的 node 版本)
下載 tarball 檔（點我下載）

安裝步驟：

# 安裝 MCP 套件 （請依據您的 tarball 檔位置調整指令路徑）
npm install -g ./OEN-Tech-oen-payment-mcp-server-1.0.5.tgz

MCP 客戶端配置：

在您的 MCP 客戶端配置中加入：

{
  "mcpServers": {
    "oen-payment": {
      "command": "oen-payment-mcp-server",
      "args": [
        "--merchantId=<測試商戶ID（您的 Domain)>",
        "--token=<API Token(從 CRM 取得)>"
      ]
    }
  }
}

各家廠商的配置方式可能有所不同
此產品為測試用途，暫不提供公開的 npm package registry

🍌 一鍵安裝 (Claude 用戶專用)

前置需求

確保已安裝 Claude Desktop
下載 dxt 檔（點我下載）
若安裝後無法運行，請嘗試手動安裝 Node.js(>=22.14.0)

安裝步驟

雙擊已下載的 dxt 檔，接著會啟動 Claude Desktop 應用程式
- 若點擊無法 Claude Desktop 請依下列步驟安裝
  - 開啟 Claude Desktop -> Settings -> Extensions -> 拖拉 dxt 到該視窗
點擊 “Install”
配置 MerchantId 以及 API Token

🍌 可用工具

工具	描述	使用場景
`checkoutLink`	建立單筆交易	建立單筆交易，並提供付款連結（注意：若沒指定 `successUrl` 及 `failureUrl` 預設成功或失敗都會轉跳到您的應援頁面）
`getTransaction`	透過 ID 查詢交易	檢查付款狀態
`subscriptionCheckout`	建立定期定額交易	建立定期定額交易，並提供付款連結 `successUrl` 及 `failureUrl` 預設成功或失敗都會轉跳到您的應援頁面）
`scheduledSubscriptionCheckout`	建立未來排程付款交易	建立未來排程付款交易，建立單筆交易，並提供付款連結（注意：若沒指定 `successUrl` 及 `failureUrl` 預設成功或失敗都會轉跳到您的應援頁面）
`getSubscription`	查詢訂閱詳情	管理定期付款
`getTransactions`	列出所有交易	付款歷史
`getTransactionsByOrderId`	透過訂單查找交易	訂單追蹤
`cancelSubscription`	取消定期付款	停止訂閱
`exchangeTokenBy3D`	信用卡透過 3D 驗證取得交易 Token	儲存 Token，用以日後交易(Token 會透過 Webhooks 發送)
`readDocs`	讀取 API 文檔	整合協助
`getConfig`	取得商戶配置	環境資訊

🍌 系統需求

Node.js >=22.14.0
應援金流服務已啟用

🍌 文件

常見 MCP 配置文件

🍌 問題排除

配置後運行失敗：
- 確保是否安裝 Node.js，並檢查 Node.js 版本是否 >=22.14.0
- 確認 merchantId 及 token 是否確實配置
- 若為 Windows 用戶，請試著使用 WSL 環境運行，或嘗試使用管理者權限執行您的工具
- 確認您的金流測試環境已經確實開通
MCP Server 沒出現在已安裝的清單: 配置完成後，試著重啟您的工具
運行成功但無法正確調用 MCP Tool：
- 請試著提供更明確的 prompt
- 確認您的工具是否啟用 Oen Payment Mcp Server
MCP Tool 成功執行但回應出現錯誤:
- 建議查看 tool 回應的錯誤訊息
- status code 回應 401: 確認 API Token 是否正確
- status code 回應 400: 建議參閱應援金流文件 - 系統回應代碼對照表章節
AI 工具回應超出限制或訊息過長: 確保目前的 AI 工具收費模式沒超出限制，免費版本可能更容易碰到該瓶頸。若無法付費使用，建議可以將不需要的 tool 給關掉，避免 AI 工具消耗過多 token

🍌 注意事項

此產品屬於開發測試階段，請不要使用在 Production 環境
此產品為測試用途，未來不會提供任何更新，請留意正式版本的消息
請妥善保管 API Token
避免安裝來路不明的 MCP Server

Power by the Oen Team 🐵⚡️

oen-payment-mcp-server

🍌 功能特色

🍌 使用方式

🍌 本地 MCP 伺服器設置

前置需求：

安裝步驟：

MCP 客戶端配置：

🍌 一鍵安裝 (Claude 用戶專用)

前置需求

安裝步驟

🍌 可用工具

🍌 系統需求

🍌 文件

相關文件

常見 MCP 配置文件

🍌 問題排除

🍌 注意事項