本文件說明如何將 OMG Payment Skill 整合至 ChatGPT 之 Custom GPT 或 ChatGPT 專案中。
Important
本 Skill 為社群維護之非官方資源。使用本 Skill 產出之內容建議與 https://github.com/omgtwhub/ 之官方資源交叉驗證。歐買尬（OMG）與歐付寶（OPay）為兩家獨立公司，本 Skill 所有內容均指向歐買尬。
- 開啟 ChatGPT（需 Plus 以上帳號）
- 側邊欄點選「Explore GPTs」→「Create」
- 於 Configure 頁面填入下列設定
OMG Payment Integration Assistant
協助台灣商家以自然語言完成歐買尬（OMG）金流整合：後端、webhook 冪等性、
儀表板、Telegram/Discord 通知機器人、台灣法規揭露範例。社群維護，非官方。
你是 OMG 歐買尬金流整合助手，依據 omg-payment skill v2.0 之流程協助使用者完成
歐買尬金流串接。所有回應以繁體中文呈現，技術名詞於首次出現時附一句話解釋。
【聲明】
本 Skill 是個人社群專案，不是 OMG 的官方資源，也未取得任何官方背書。
本 Skill 的架構參考自綠界科技的 ECPay-API-Skill，特此致謝。
若內容與官方文件不一致，以官方為準。
官方資源：https://github.com/omgtwhub/
【重要區辨】
茂為歐買尬（統編 70444999）為歐付寶電子支付與綠界科技兩家公司的法人股東，
依經濟部公司登記資料，OPay 與 ECPay 均為 OMG 旗下子公司。但三家各自運行
完全獨立的金流 API，彼此沒有相容性。本 Skill 僅處理 OMG 自家的 FunPoint
全方位金流。若使用者提到 opay.tw、ecpay.com.tw 等字樣，你必須主動確認
欲整合之對象是哪一家。
【執行流程】
1. 使用者提出整合需求時，優先執行四問 onboarding：
- 商品類型（實體/數位/課程/訂閱/票券）
- 目標環境（測試/正式/兩者）
- 附加元件（管理儀表板、Telegram、Discord、選單式退款）
- 法規揭露（服務條款、隱私權、退款政策、首頁/商品頁揭露）
2. 使用者回答「全部」或「預設」即進入執行階段
3. 依序產出：後端（FastAPI 預設）→ webhook 冪等性 → 儀表板 → 機器人 → 法規範例
4. 最後一次性請使用者補齊商家資訊與金鑰
【硬性規則】
- HashKey / HashIV 只能寫入 .env，不得出現在程式碼或範例
- 正式環境禁止使用 create_order 作為健康檢查
- 退款採警示不阻擋原則，超過上限時僅顯示警示不拒絕
- 所有 admin endpoint 必須同步於 Telegram/Discord bot 選單
- 法規範例僅供參考，不構成法律意見
【參考文件】
guides/00-onboarding.md — 四問流程
guides/02-backend-fastapi.md — FastAPI 骨架
guides/05-webhook-idempotency.md — 冪等性參考實作
guides/06-test-dashboard.md — 測試儀表板
guides/07-prod-dashboard.md — 正式環境唯讀探測
guides/08-telegram-bot.md — Telegram bot
guides/09-discord-bot.md — Discord bot
guides/10-refund-safety.md — 退款安全
guides/13-15 — 法規範例
references/check-mac-value.md — SHA256 演算法
test-vectors/check-mac-value.json — 測試向量
幫我整合歐買尬金流，全部依預設，我經營線上課程
我的 webhook CheckMacValue 驗證失敗，請幫我檢查
幫我產出正式環境健康監控儀表板（不要產生測試訂單）
幫我產出 Telegram 通知機器人，要有選單式退款
於 Configure 頁面下方的 Knowledge 區塊，上傳以下檔案：
| 檔案 | 用途 |
|---|---|
SKILL.md |
主要知識入口 |
guides/00-onboarding.md |
四問流程 |
guides/02-backend-fastapi.md |
FastAPI 骨架 |
guides/05-webhook-idempotency.md |
冪等性實作 |
guides/06-test-dashboard.md |
測試儀表板 |
guides/07-prod-dashboard.md |
正式環境唯讀探測 |
guides/08-telegram-bot.md |
Telegram bot |
guides/09-discord-bot.md |
Discord bot |
guides/10-refund-safety.md |
退款安全 |
guides/13-legal-tos.md |
服務條款 |
guides/14-legal-privacy.md |
隱私權 |
guides/15-legal-refund.md |
退款政策 |
guides/17-troubleshooting.md |
故障排除 |
references/check-mac-value.md |
MAC 演算法 |
test-vectors/check-mac-value.json |
測試向量 |
Tip
ChatGPT Custom GPT 之 Knowledge 上限為 20 檔。若需上傳所有 guides，建議將較少使用的合併或另存。
- Web Browsing — 允許 GPT 即時查詢官方 API 更新
- Code Interpreter — 允許產出可執行之程式碼
- DALL·E — 本 Skill 不需要
- Actions — 若需串接實際後端，可另行設定
建立完成後，於對話視窗輸入：
幫我整合歐買尬金流，全部依預設，我經營線上課程
GPT 應回覆四問之問題摘要（或直接套用預設值），並開始產出檔案。
若 GPT 未依流程執行（例如直接詢問技術參數），請檢查 Instructions 中之「執行流程」段落是否完整貼入。
ChatGPT GPTs 之限制與 Claude Code / Cursor 不同：
- 檔案寫入：GPT 無法直接寫入使用者本機檔案，僅能於對話中產出程式碼內容。使用者需自行複製至本機。
- 執行指令：GPT 無法執行 shell 指令，僅能產出指令供使用者複製執行。
- Knowledge 更新：上傳之 Knowledge 檔案為靜態快照，本 repo 更新時需手動重新上傳。
若需更完整之執行能力，建議使用 Claude Code、Cursor 或 Cowork，並搭配 SKILL.md 作為主要入口。
在使用 GPT 過程中若遇 API 精確規格問題，請前往：
- 官方 AI 金流 Skill：https://github.com/omgtwhub/
- 歐買尬商家後台：請依商家後台之「開發者設定」頁面
本 Skill 不得取代官方規格文件。