oen-payment

  ___               ____                                  _
 / _ \  ___ _ __   |  _ \ __ _ _   _ _ __ ___   ___ _ __ | |_
| | | |/ _ \ '_ \  | |_) / _` | | | | '_ ` _ \ / _ \ '_ \| __|
| |_| |  __/ | | | |  __/ (_| | |_| | | | | | |  __/ | | | |_
 \___/ \___|_| |_| |_|   \__,_|\__, |_| |_| |_|\___|_| |_|\__|
                               |___/
 ____  _    _ _ _
/ ___|| | _(_) | |
\___ \| |/ / | | |
 ___) |   <| | | |
|____/|_|\_\_|_|_|

Oen Payment Skill — 應援金流 AI 技能

讓你的 AI 編程助手成為金流整合專家

這是一個 AI 編程助手技能（Skill），協助開發者快速整合 Oen Payment（應援金流） REST API。安裝後，AI 助手會在你提及金流相關需求時自動啟用，提供 API 串接指引、程式碼生成、錯誤排查等服務。

相容的 AI 編程助手

本技能採用標準 SKILL.md 格式，相容於所有支援此規範的 AI 編程框架：

技能本身為純 Markdown + YAML frontmatter，不依賴任何框架特定的 API 或工具呼叫。

功能特色

• API 串接引導 — 逐步引導你完成付款頁面建立、定期定額、退款、交易查詢等操作
• 多語言程式碼生成 — 產生可直接使用的 TypeScript、JavaScript、Python 或 cURL 範例程式碼
• 錯誤排查 — 根據回應碼對照表快速診斷問題，提供解決建議
• MCP Server 設定 — 引導設定 Oen Payment MCP Server，實現 AI 輔助的金流操作
• 完整 API 文件 — 內建所有 endpoint 的請求格式、回應格式、範例和測試卡號

支援的付款方式

安裝方式

Claude Code

# 全域安裝（所有專案可用）
git clone https://github.com/OEN-Tech/oen-payment-skill.git ~/.claude/skills/oen-payment

# 或專案級安裝（僅限當前專案）
git clone https://github.com/OEN-Tech/oen-payment-skill.git .claude/skills/oen-payment

OpenClaw

git clone https://github.com/OEN-Tech/oen-payment-skill.git ~/.openclaw/skills/oen-payment

其他框架

將本 repo 複製到你的框架所指定的技能目錄即可。核心檔案為 SKILL.md，技能載入時會讀取此檔案及 references/ 目錄下的參考文件。

安裝完成後，重新啟動你的 AI 編程助手即可生效。

使用方式

安裝後，當你在 AI 助手中提及以下關鍵字時，技能會自動觸發：

• oen payment、應援金流、oen 金流
• 付款、結帳、checkout
• 定期定額、subscription
• 退款、refund
• 交易查詢、transaction

範例對話

> 幫我用 TypeScript 串接 Oen Payment 建立一個結帳頁面

> 如何設定 Oen Payment 的 webhook？

> 退款時收到 T0001 錯誤碼是什麼意思？

> 幫我建立一個每月扣款 500 元的定期定額

搭配 MCP Server 使用

除了此技能外，你也可以安裝 Oen Payment MCP Server 來取得即時的金流操作能力（建立交易、查詢交易、退款等）。MCP Server 可搭配任何支援 MCP 協定的 AI 工具使用。

快速設定

1. 設定 GitHub Packages 存取權限：

echo "@OEN-Tech:registry=https://npm.pkg.github.com" >> ~/.npmrc
echo "//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN" >> ~/.npmrc

1. 在你的 AI 工具的 MCP 設定中加入：

{
  "mcpServers": {
    "oen-payment": {
      "command": "npx",
      "args": [
        "-y",
        "@OEN-Tech/oen-payment-mcp-server@latest",
        "--token=YOUR_API_TOKEN",
        "--merchantId=YOUR_MERCHANT_ID",
        "--env=testing"
      ]
    }
  }
}

1. 將 YOUR_API_TOKEN 替換為從應援 CRM 後台取得的 API Token，YOUR_MERCHANT_ID 替換為你的網域名稱。

API 快速參考

主要 Endpoint

環境

測試卡號

測試提示：金額 > 100 為成功情境，金額 < 100 為失敗情境

系統回應代碼

檔案結構

oen-payment-skill/
├── SKILL.md              # 技能定義檔（AI 助手載入此檔）
├── references/
│   └── api-docs.md       # 完整 API 文件參考
├── README.md             # 本文件
└── LICENSE               # MIT 授權

相關資源

• Oen 應援科技官網
• Oen Payment MCP Server
• Claude Code 文件
• OpenClaw

授權

MIT License — 詳見 LICENSE

---

Power by the Oen Team