跳到內容

Payment Skill

在 ChatGPT 開啟在 Claude 開啟

Payment Skill 是一份給 AI 開發工具讀的技能檔(SKILL.md 加上參考文件)。安裝後,當你在工具裡提到「應援金流」「oen payment」「定期定額」「退款」等關鍵字,AI 會自動載入 Payment API 的串接知識,幫你產生程式、解釋錯誤碼。

  1. 把 repo 複製到工具的技能目錄。以 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
  2. 重新啟動 AI 工具。

  3. 試著問:「幫我用 TypeScript 串接應援金流,建立一個結帳頁」。

幾個 AI 最容易寫錯、請你特別檢查的地方:

  • productDetails 在所有結帳 API 都是必填,品項的「數量 × 單價」合計必須等於 amount。見單次付款。
  • 退款不只信用卡:LINE Pay、超商代碼、ATM 也能用 API 退,超商與 ATM 要帶退款帳戶。見退款。
  • 付款通知最多送 3 次,間隔 2 秒、4 秒,而且沒有簽章。見付款通知。
  • 取消定期定額只接受 S 開頭的定期定額編號。見取消定期定額。
  • Payment MCP 目前是內部預覽版,尚未對外開放,見 Payment MCP。

Skill 只提供知識,實際呼叫 API 仍需要 CRM 產生的 token。取得方式見驗證與 token。