繁體中文 | English
這是 AI Skill 檔案，讓 AI 助手（如 Claude Code、Cowork、ChatGPT）能夠理解 OMG 金流（歐買尬第三方支付）的完整 API 規格，並協助開發者快速產生正確的串接程式碼。
- 公司名稱：茂為歐買尬數位科技股份有限公司
- 英文名稱：MacroWell OMG Digital Entertainment Co., Ltd.
- 服務地區：台灣 (Taiwan)
- API 文件版本：V 1.4.9 (2025-11)
- AioCheckOut/V5 — 產生訂單（一次性付款、分期付款、定期定額）
- QueryTradeInfo/V5 — 查詢訂單狀態
- QueryCreditCardPeriodInfo — 查詢定期定額訂單資訊
- CreditCardPeriodAction — 定期定額訂單作業（停用）
- DoAction (CreditDetail/DoAction) — 信用卡請退款（關帳/退刷/取消/放棄）
- QueryTrade/V2 (CreditDetail/QueryTrade/V2) — 查詢信用卡單筆明細
- 信用卡一次性付款（Credit）
- 信用卡分期付款（CreditInstallment: 3/6/12/18/24/30 期）
- 信用卡定期定額/訂閱制（Recurring: PeriodType D/M/Y）
- ATM 虛擬帳號轉帳（ATM: 第一銀行/中國信託/聯邦/凱基）
- 超商代碼繳款（CVS: 超商代碼/全家/7-11）
- 超商條碼繳款（BARCODE: 三段式條碼 Code39）
- AFTEE 先享後付
- CheckMacValue SHA256 驗證（含 .NET URL Encode 替換）
- 付款結果通知處理（ReturnURL / OrderResultURL）
- ATM/CVS/BARCODE 取號結果通知（PaymentInfoURL）
- 定期定額後續扣款通知（PeriodReturnURL）
- 額外付款資訊回傳（NeedExtraPaidInfo=Y）
- 完整錯誤碼參考與除錯指南
- 正式環境遷移指南
- 冪等性處理與最佳實踐
- Python (FastAPI) 完整範例
- Node.js (Express.js) 範例
- PHP 範例
- .NET/C# 範例
- CheckMacValue 計算（Python / Node.js / PHP / .NET）
# 在你的專案根目錄
mkdir -p .skills/skills/omg-payment
cp SKILL.md .skills/skills/omg-payment/SKILL.mdClaude Code 或 Cowork 會自動讀取此 Skill 來協助你串接金流。
# 使用 OpenAI 格式的 Skill 檔案
cp SKILL_OPENAI.md your-project/將 SKILL_OPENAI.md 的內容貼入 ChatGPT 的 Custom Instructions，或上傳檔案後說「請根據這份金流文件幫我串接」。
將 Skill 檔案的內容貼給 AI，或上傳檔案後說「請根據這份金流文件幫我串接 OMG 金流」。
| 項目 | 值 |
|---|---|
| MerchantID | 1000031 |
| HashKey | 265fIDjIvesceXWM |
| HashIV | pOOvhGd1V2pJbjfX |
| 測試卡號 | 4311-9522-2222-2222 |
| CVV | 222 |
| 有效期限 | 任意未過期月/年 |
| 廠商後台 | https://vendor-stage.funpoint.com.tw |
| 後台帳密 | funstage001 / test1234 |
omg-payment-skill/
├── README.md # 本說明文件 (中英雙語)
├── SKILL.md # Claude Skill 主體（Claude Code / Cowork 用）
├── SKILL_OPENAI.md # OpenAI Skill 主體（ChatGPT / OpenAI 用）
├── LICENSE # MIT License
└── examples/
└── fastapi_example.py # FastAPI 完整串接範例（涵蓋所有 API）
This is an AI Skill file that enables AI assistants (such as Claude Code, Cowork, ChatGPT) to understand the complete API specification of the OMG Payment Gateway (歐買尬 third-party payment) and help developers quickly generate correct integration code.
- Company (Chinese): 茂為歐買尬數位科技股份有限公司
- Company (English): MacroWell OMG Digital Entertainment Co., Ltd.
- Service Region: Taiwan (台灣)
- API Document Version: V 1.4.9 (2025-11)
- AioCheckOut/V5 — Create Order (one-time, installment, recurring)
- QueryTradeInfo/V5 — Query Trade Info
- QueryCreditCardPeriodInfo — Query Recurring Payment Info
- CreditCardPeriodAction — Recurring Payment Action (Cancel)
- DoAction (CreditDetail/DoAction) — Credit Card Capture/Refund/Cancel/Abandon
- QueryTrade/V2 (CreditDetail/QueryTrade/V2) — Query Credit Card Transaction Detail
- Credit Card one-time payment
- Credit Card installment (3/6/12/18/24/30 periods, E.SUN Bank only)
- Credit Card recurring/subscription (Daily/Monthly/Yearly)
- ATM virtual account (First Bank, CTBC, Union Bank, KGI)
- CVS payment code (CVS code, FamilyMart, 7-11 ibon)
- CVS barcode (3-segment Code39 barcode)
- AFTEE buy now pay later
- CheckMacValue SHA256 verification (with .NET URL Encode replacements)
- Payment result notification handling (ReturnURL / OrderResultURL)
- ATM/CVS/BARCODE payment info notification (PaymentInfoURL)
- Recurring payment notification (PeriodReturnURL)
- Extra payment info return (NeedExtraPaidInfo=Y)
- Complete error code reference and debug guide
- Production migration guide
- Idempotency handling and best practices
- Python (FastAPI) complete example
- Node.js (Express.js) example
- PHP example
- .NET/C# example
- CheckMacValue calculation (Python / Node.js / PHP / .NET)
# In your project root
mkdir -p .skills/skills/omg-payment
cp SKILL.md .skills/skills/omg-payment/SKILL.mdClaude Code or Cowork will automatically read this Skill to assist you with payment integration.
# Use the OpenAI format Skill file
cp SKILL_OPENAI.md your-project/Paste the contents of SKILL_OPENAI.md into ChatGPT's Custom Instructions, or upload the file and say "Please help me integrate the payment gateway based on this document."
Paste the Skill file contents to the AI, or upload the file and ask for integration help.
| Item | Value |
|---|---|
| MerchantID | 1000031 |
| HashKey | 265fIDjIvesceXWM |
| HashIV | pOOvhGd1V2pJbjfX |
| Test Card | 4311-9522-2222-2222 |
| CVV | 222 |
| Expiry | Any future date |
| Vendor Backend | https://vendor-stage.funpoint.com.tw |
| Backend Login | funstage001 / test1234 |
omg-payment-skill/
├── README.md # This file (bilingual)
├── SKILL.md # Claude Skill body (for Claude Code / Cowork)
├── SKILL_OPENAI.md # OpenAI Skill body (for ChatGPT / OpenAI)
├── LICENSE # MIT License
└── examples/
└── fastapi_example.py # Complete FastAPI integration example (all APIs)
MIT License - 自由使用、修改、分享。Free to use, modify, and share.
Mitchell Chen
本專案由 Mitchell Chen 編寫，透過 Claude (Anthropic) AI 輔助完成。 This project was written by Mitchell Chen, with assistance from Claude (Anthropic) AI.