taiwan-payment-skill 1.5.3 → 1.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/README.md +26 -17
  2. package/assets/taiwan-payment/CLAUDE.md +26 -23
  3. package/assets/taiwan-payment/EXAMPLES.md +1 -5
  4. package/assets/taiwan-payment/README.md +25 -16
  5. package/assets/taiwan-payment/SKILL.md +11 -9
  6. package/assets/taiwan-payment/data/error-codes.csv +1628 -4
  7. package/assets/taiwan-payment/data/payment-methods.csv +6 -6
  8. package/assets/taiwan-payment/examples/ecpay-payment-example.py +1 -2
  9. package/assets/taiwan-payment/examples/ezpay-payment-example.py +0 -2
  10. package/assets/taiwan-payment/examples/jkopay-payment-example.py +13 -15
  11. package/assets/taiwan-payment/examples/linepay-payment-example.py +2 -5
  12. package/assets/taiwan-payment/examples/newebpay-payment-example.py +0 -1
  13. package/assets/taiwan-payment/examples/paynow-payment-example.py +3 -4
  14. package/assets/taiwan-payment/examples/payuni-payment-example.py +2 -2
  15. package/assets/taiwan-payment/examples/pchomepay-payment-example.py +0 -1
  16. package/assets/taiwan-payment/examples/shopline-payment-example.py +0 -1
  17. package/assets/taiwan-payment/examples/smilepay-payment-example.py +0 -1
  18. package/assets/taiwan-payment/examples/sunpay-payment-example.py +14 -16
  19. package/assets/taiwan-payment/examples/tappay-payment-example.py +0 -1
  20. package/assets/taiwan-payment/references/ecpay-payment-api.md +0 -2
  21. package/assets/taiwan-payment/references/ezpay-payment-api.md +0 -4
  22. package/assets/taiwan-payment/references/gomypay-payment-api.md +1 -2
  23. package/assets/taiwan-payment/references/jkopay-payment-api.md +2 -9
  24. package/assets/taiwan-payment/references/linepay-payment-api.md +2 -6
  25. package/assets/taiwan-payment/references/opay-payment-api.md +1 -1
  26. package/assets/taiwan-payment/references/paynow-payment-api.md +0 -3
  27. package/assets/taiwan-payment/references/payuni-payment-api.md +1 -3
  28. package/assets/taiwan-payment/references/pchomepay-payment-api.md +0 -3
  29. package/assets/taiwan-payment/references/shopline-payment-api.md +0 -3
  30. package/assets/taiwan-payment/references/smilepay-payment-api.md +1 -6
  31. package/assets/taiwan-payment/references/sunpay-payment-api.md +1 -2
  32. package/assets/taiwan-payment/references/tappay-payment-api.md +1 -5
  33. package/assets/taiwan-payment/references/twqr-ewallet-landscape.md +7 -11
  34. package/assets/taiwan-payment/scripts/core.py +3 -4
  35. package/assets/taiwan-payment/scripts/recommend.py +1 -2
  36. package/assets/taiwan-payment/scripts/search.py +4 -2
  37. package/assets/templates/base/quick-reference.md +2 -3
  38. package/assets/templates/base/skill-content.md +9 -7
  39. package/assets/templates/platforms/agent.json +2 -2
  40. package/assets/templates/platforms/claude.json +2 -2
  41. package/assets/templates/platforms/cline.json +3 -3
  42. package/assets/templates/platforms/codebuddy.json +2 -2
  43. package/assets/templates/platforms/codex.json +2 -2
  44. package/assets/templates/platforms/continue.json +2 -2
  45. package/assets/templates/platforms/copilot.json +3 -3
  46. package/assets/templates/platforms/cursor.json +2 -2
  47. package/assets/templates/platforms/gemini.json +2 -2
  48. package/assets/templates/platforms/kiro.json +3 -3
  49. package/assets/templates/platforms/opencode.json +2 -2
  50. package/assets/templates/platforms/qoder.json +2 -2
  51. package/assets/templates/platforms/trae.json +2 -2
  52. package/assets/templates/platforms/windsurf.json +2 -2
  53. package/dist/index.js +26 -28
  54. package/package.json +2 -2
  55. package/assets/templates/platforms/antigravity.json +0 -25
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  <h3 align="center">台灣金流 AI 開發技能包</h3>
4
4
 
5
5
  <p align="center">
6
- <strong>10 大金流平台一次串接</strong>
6
+ <strong>14 家金流平台一次串接</strong>
7
7
  </p>
8
8
 
9
9
  <p align="center">
@@ -13,7 +13,7 @@
13
13
  <p align="center">
14
14
  <a href="https://www.npmjs.com/package/taiwan-payment-skill"><img src="https://img.shields.io/npm/v/taiwan-payment-skill?style=flat-square&logo=npm" alt="npm version"></a>
15
15
  <a href="https://www.npmjs.com/package/taiwan-payment-skill"><img src="https://img.shields.io/npm/dm/taiwan-payment-skill?style=flat-square&label=downloads" alt="npm downloads"></a>
16
- <img src="https://img.shields.io/badge/providers-10-success?style=flat-square" alt="10 Providers">
16
+ <img src="https://img.shields.io/badge/providers-14-success?style=flat-square" alt="14 Providers">
17
17
  <img src="https://img.shields.io/badge/AI%20platforms-14-blue?style=flat-square" alt="14 AI Platforms">
18
18
  <a href="https://github.com/Moksa1123/taiwan-ecommerce-toolkit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-ecommerce-toolkit?style=flat-square" alt="License"></a>
19
19
  </p>
@@ -54,7 +54,7 @@ TapPay 用 Prime 一次付清,remember=true 存成 card_token 供下次自動
54
54
 
55
55
  ---
56
56
 
57
- ## 10 家金流平台
57
+ ## 14 家金流平台
58
58
 
59
59
  | 服務商 | 加密 / 認證 | 特色 |
60
60
  |---|---|---|
@@ -63,13 +63,17 @@ TapPay 用 Prime 一次付清,remember=true 存成 card_token 供下次自動
63
63
  | **PAYUNi 統一** | AES-256-GCM + SHA256 | RESTful JSON、AFTEE、iCash |
64
64
  | **SmilePay 速買配** | Verify_key + 加權檢核碼 | 無 AES、ibon / FamiPort 直接打單 |
65
65
  | **PChomePay 拍錢包** | Basic Auth → 8h pcpay-token | PChome 生態、5% P 幣回饋、金物流二合一 |
66
- | **ezPay 簡單付** | 同 NewebPay (AES-256-CBC) | 藍新小型商家品牌、低門檻 |
66
+ | **ezPay 簡單付** | AES-256-CBC(32-byte padding)+ SHA256 | 電子支付機構;境內 TWQR / ezPay 錢包,跨境支付寶 / 微信 |
67
67
  | **PayNow 立吉富** | JWT Bearer (現代) / 動態 AES-256 (傳統) | 雙 API、Stripe-like、Apple Pay 完整 |
68
68
  | **Shopline Payments** | merchantId + apiKey | 金額以分為單位、HMAC-SHA256 webhook |
69
69
  | **LINE Pay v4** | Channel ID/Secret + HMAC-SHA256 + Nonce | Request→Confirm 兩段、Preapproved Pay |
70
70
  | **TapPay** | Partner Key (Header) | PCI 隔離、Prime 兩段式、Card Token |
71
+ | **O'Pay 歐付寶** | SHA256 CheckMacValue(同 ECPay) | 與 ECPay 同源架構、AccountLink 銀行快付、延遲撥款 |
72
+ | **JKOPAY 街口** | api-key Header + HMAC-SHA256 digest | 線上支付 / POS / 授權扣款 |
73
+ | **SunPay 紅陽** | RSA 分段加密 + SHA256 check_value | 金流 + 發票 + 超商代收 |
74
+ | **GoMyPay** | 需申請文件 | 參數規格待補 |
71
75
 
72
- 每家附完整 Python 範例 + 反推的加密實作 + 錯誤碼對照 + 測試帳號。
76
+ O'Pay、GoMyPay 以外皆附可執行 Python 範例,加解密以官方測試向量驗證;錯誤碼見 `data/error-codes.csv`。
73
77
 
74
78
  ## 技能包內容
75
79
 
@@ -77,23 +81,28 @@ TapPay 用 Prime 一次付清,remember=true 存成 card_token 供下次自動
77
81
  taiwan-payment/
78
82
  ├── SKILL.md # AI 技能主文檔
79
83
  ├── EXAMPLES.md # 實戰範例集
80
- ├── references/ # 10 份 API 規格 (~9,200 行)
84
+ ├── references/ # 各服務商 API 規格
81
85
  │ ├── ecpay-payment-api.md
82
86
  │ ├── newebpay-payment-api.md
83
87
  │ ├── payuni-payment-api.md
84
- │ ├── smilepay-payment-api.md # 反推 Mid_smilepay 加權檢核碼
88
+ │ ├── smilepay-payment-api.md # Mid_smilepay 加權檢核碼
85
89
  │ ├── pchomepay-payment-api.md # 含 8h token 流程
86
- │ ├── ezpay-payment-api.md # diff vs Newebpay
90
+ │ ├── ezpay-payment-api.md # 電子支付平台 + 跨境(依官方手冊)
87
91
  │ ├── paynow-payment-api.md # 雙 API 並行
88
92
  │ ├── shopline-payment-api.md # Redirect + Embedded
89
93
  │ ├── linepay-payment-api.md # HMAC + Preapproved
90
- │ └── tappay-payment-api.md # Prime + Token 重複扣款
91
- ├── examples/ # 10 個生產級 Python 範例
92
- └── data/ # 7 份 CSV
93
- ├── providers.csv # 10 服務商完整比較
94
- ├── operations.csv # 26 個 API 操作
95
- ├── payment-methods.csv # 25+ 支付方式對照
96
- ├── error-codes.csv # 130+ 錯誤碼
94
+ │ ├── tappay-payment-api.md # Prime + Token 重複扣款
95
+ │ ├── opay-payment-api.md
96
+ │ ├── jkopay-payment-api.md
97
+ │ ├── sunpay-payment-api.md
98
+ │ ├── gomypay-payment-api.md
99
+ │ └── twqr-ewallet-landscape.md # 電子支付/TWQR 生態
100
+ ├── examples/ # 可執行 Python 範例
101
+ └── data/ # search / recommend 使用的 CSV
102
+ ├── providers.csv
103
+ ├── operations.csv
104
+ ├── payment-methods.csv
105
+ ├── error-codes.csv # 各家官方錯誤碼
97
106
  └── ...
98
107
  ```
99
108
 
@@ -115,8 +124,8 @@ Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Co
115
124
 
116
125
  本套件是 **[Taiwan E-Commerce Toolkit](https://github.com/Moksa1123/taiwan-ecommerce-toolkit)** 的一部分:
117
126
 
118
- - [taiwan-invoice-skill](https://www.npmjs.com/package/taiwan-invoice-skill) — 5 家電子發票
119
- - [taiwan-logistics-skill](https://www.npmjs.com/package/taiwan-logistics-skill) — 7 家物流(含 HCT 直連)
127
+ - [taiwan-invoice-skill](https://www.npmjs.com/package/taiwan-invoice-skill) — 7 家電子發票加值中心 + 財政部大平台查詢
128
+ - [taiwan-logistics-skill](https://www.npmjs.com/package/taiwan-logistics-skill) — 7 家物流 aggregator + HCT 直連 + 3 家即時配送
120
129
 
121
130
  ## 授權
122
131
 
@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
4
4
 
5
5
  ## Project Overview
6
6
 
7
- Taiwan Payment Skill is an AI-powered toolkit for Taiwan Payment Gateway integration, providing API documentation, code examples, and scripts for major payment platforms (ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow). It works as a skill/workflow for AI coding assistants (Claude Code, Windsurf, Cursor, etc.).
7
+ Taiwan Payment Skill is an AI-powered toolkit for Taiwan Payment Gateway integration, providing API documentation, code examples, and scripts for Taiwan payment platforms (ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay, GoMyPay). It works as a skill/workflow for AI coding assistants (Claude Code, Windsurf, Cursor, etc.).
8
8
 
9
9
  ## Available Scripts
10
10
 
@@ -41,22 +41,28 @@ taiwan-payment/ # Source of Truth
41
41
  │ ├── paynow-payment-api.md
42
42
  │ ├── shopline-payment-api.md
43
43
  │ ├── linepay-payment-api.md
44
- │ └── tappay-payment-api.md
44
+ │ ├── tappay-payment-api.md
45
+ │ ├── opay-payment-api.md
46
+ │ ├── jkopay-payment-api.md
47
+ │ ├── sunpay-payment-api.md
48
+ │ ├── gomypay-payment-api.md
49
+ │ └── twqr-ewallet-landscape.md
45
50
  ├── scripts/ # Utility scripts
46
51
  │ ├── core.py # BM25 search engine
47
52
  │ ├── recommend.py # Recommendation system
48
- │ ├── search.py # Search CLI (150+ lines)
49
- │ └── test_payment.py # Connection testing
50
- └── data/ # Data-driven architecture (7 CSVs)
51
- ├── providers.csv # 14 providers(含 doc_access 文件公開程度分級)
52
- ├── operations.csv # 8 API operations
53
- ├── error-codes.csv # 1190 error codes(11 家,依各家官方文件重建)
54
- ├── field-mappings.csv # 19 欄位 × 14 家 provider 對照
55
- ├── payment-methods.csv # 40 payment methods
56
- ├── reasoning.csv # 30+ recommendation rules
57
- └── troubleshooting.csv # 16 troubleshooting cases
58
-
59
- cli/ # CLI installer (taiwan-payment-skill on npm)
53
+ │ ├── search.py # Search CLI
54
+ │ └── test_payment.py # 已知答案測試 + 測試環境連線
55
+ ├── examples/ # 可執行範例(CI 以官方測試向量驗證)
56
+ └── data/ # search / recommend 使用的 CSV
57
+ ├── providers.csv # 14 家(含 doc_access 文件公開程度分級)
58
+ ├── operations.csv
59
+ ├── error-codes.csv # 依各家官方文件重建
60
+ ├── field-mappings.csv
61
+ ├── payment-methods.csv
62
+ ├── reasoning.csv
63
+ └── troubleshooting.csv
64
+
65
+ payment-cli/ # CLI installer (taiwan-payment-skill on npm)
60
66
  ├── src/
61
67
  │ ├── commands/init.ts # Install command with template generation
62
68
  │ ├── utils/template.ts # Template rendering engine
@@ -84,7 +90,7 @@ When modifying files:
84
90
  - `scripts/*.py` - Utility scripts
85
91
  - `data/*.csv` - Data files
86
92
 
87
- 2. **Templates** - Edit in `cli/assets/templates/`:
93
+ 2. **Templates** - Edit in `payment-cli/assets/templates/`:
88
94
  - `base/skill-content.md` - Common skill content
89
95
  - `base/quick-reference.md` - Quick reference (Claude only)
90
96
  - `platforms/*.json` - Platform-specific configs (14 platforms)
@@ -220,7 +226,7 @@ All core logic is in CSV files:
220
226
  - **error-codes.csv** - Error code lookup table
221
227
  - **field-mappings.csv** - Field name mappings across providers
222
228
  - **payment-methods.csv** - Payment method details
223
- - **reasoning.csv** - Recommendation rules (30+ scenarios)
229
+ - **reasoning.csv** - Recommendation rules
224
230
  - **troubleshooting.csv** - Common issues and solutions
225
231
 
226
232
  To add new data, edit CSV files directly. No code changes needed.
@@ -320,17 +326,14 @@ HashIV: 請至後台申請
320
326
 
321
327
  Before publishing to npm:
322
328
 
323
- 1. Update version in `cli/package.json`
329
+ 1. Update version in `payment-cli/package.json`
324
330
  2. Sync assets: 由 `npm run build` 自動處理(`scripts/sync-assets.mjs`)
325
- 3. Build CLI: `cd cli && npm run build`
331
+ 3. Build CLI: `cd payment-cli && npm run build`
326
332
  4. Test locally: `npm test`
327
333
  5. Publish: `npm publish`
328
334
 
329
335
  ## Related Projects
330
336
 
331
- - **Taiwan Invoice Skill** - E-Invoice integration (ECPay, SmilePay, Amego)
332
- - **Taiwan Logistics Skill** - Logistics integration (ECPay, NewebPay, PAYUNi)
337
+ - **Taiwan Invoice Skill** - E-Invoice integration (ECPay, SmilePay, Amego, ezPay, PayNow, O'Pay, SunPay)
338
+ - **Taiwan Logistics Skill** - Logistics integration (ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, PayNow, ezShip, HCT, on-demand delivery)
333
339
 
334
- ---
335
-
336
- **Last Updated**: 2026-01-29
@@ -1248,7 +1248,7 @@ ezPay 簡單付是**電子支付機構**,官方提供兩組 API(演算法相
1248
1248
 
1249
1249
  1. **AES 以 32 bytes 補齊**:`EncryptData = hex(AES-256-CBC(urlencode(參數)))`,PKCS#7 區塊大小 32;用 16 bytes 補齊會與官方範例不符。
1250
1250
  2. **回應是 urlencoded,不是 JSON**:電子支付平台的 EncryptData 解密後是 `Status=SUCCESS&...&Result%5BTradeNo%5D=...`,要自行把 `Result[...]` 還原成巢狀;跨境才是 JSON。
1251
- 3. **不是藍新 NewebPay**:網域、外層欄位、Version、支付工具都不同。舊版本文件說「與 NewebPay MPG 完全相同」並指向 `spgateway.com`,是錯的。
1251
+ 3. **不是藍新 NewebPay**:網域、外層欄位、Version、支付工具都不同。
1252
1252
 
1253
1253
  ---
1254
1254
 
@@ -1390,7 +1390,3 @@ https://payment-stage.opay.tw/Cashier/AioCheckOut/V5
1390
1390
  ## GoMyPay 範例
1391
1391
 
1392
1392
  尚無範例——目前只取得服務層資訊,參數層需洽客服取得完整 API 文件。見 [reference](references/gomypay-payment-api.md)。
1393
-
1394
- ---
1395
-
1396
- **更多範例持續更新中...**
@@ -3,7 +3,7 @@
3
3
  <h3 align="center">台灣金流 AI 開發技能包</h3>
4
4
 
5
5
  <p align="center">
6
- <strong>10 大金流平台一次串接</strong>
6
+ <strong>14 家金流平台一次串接</strong>
7
7
  </p>
8
8
 
9
9
  <p align="center">
@@ -13,7 +13,7 @@
13
13
  <p align="center">
14
14
  <a href="https://www.npmjs.com/package/taiwan-payment-skill"><img src="https://img.shields.io/npm/v/taiwan-payment-skill?style=flat-square&logo=npm" alt="npm version"></a>
15
15
  <a href="https://www.npmjs.com/package/taiwan-payment-skill"><img src="https://img.shields.io/npm/dm/taiwan-payment-skill?style=flat-square&label=downloads" alt="npm downloads"></a>
16
- <img src="https://img.shields.io/badge/providers-10-success?style=flat-square" alt="10 Providers">
16
+ <img src="https://img.shields.io/badge/providers-14-success?style=flat-square" alt="14 Providers">
17
17
  <img src="https://img.shields.io/badge/AI%20platforms-14-blue?style=flat-square" alt="14 AI Platforms">
18
18
  <a href="https://github.com/Moksa1123/taiwan-ecommerce-toolkit/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-ecommerce-toolkit?style=flat-square" alt="License"></a>
19
19
  </p>
@@ -54,7 +54,7 @@ TapPay 用 Prime 一次付清,remember=true 存成 card_token 供下次自動
54
54
 
55
55
  ---
56
56
 
57
- ## 10 家金流平台
57
+ ## 14 家金流平台
58
58
 
59
59
  | 服務商 | 加密 / 認證 | 特色 |
60
60
  |---|---|---|
@@ -68,8 +68,12 @@ TapPay 用 Prime 一次付清,remember=true 存成 card_token 供下次自動
68
68
  | **Shopline Payments** | merchantId + apiKey | 金額以分為單位、HMAC-SHA256 webhook |
69
69
  | **LINE Pay v4** | Channel ID/Secret + HMAC-SHA256 + Nonce | Request→Confirm 兩段、Preapproved Pay |
70
70
  | **TapPay** | Partner Key (Header) | PCI 隔離、Prime 兩段式、Card Token |
71
+ | **O'Pay 歐付寶** | SHA256 CheckMacValue(同 ECPay) | 與 ECPay 同源架構、AccountLink 銀行快付、延遲撥款 |
72
+ | **JKOPAY 街口** | api-key Header + HMAC-SHA256 digest | 線上支付 / POS / 授權扣款 |
73
+ | **SunPay 紅陽** | RSA 分段加密 + SHA256 check_value | 金流 + 發票 + 超商代收 |
74
+ | **GoMyPay** | 需申請文件 | 參數規格待補 |
71
75
 
72
- 每家附完整 Python 範例 + 反推的加密實作 + 錯誤碼對照 + 測試帳號。
76
+ O'Pay、GoMyPay 以外皆附可執行 Python 範例,加解密以官方測試向量驗證;錯誤碼見 `data/error-codes.csv`。
73
77
 
74
78
  ## 技能包內容
75
79
 
@@ -77,23 +81,28 @@ TapPay 用 Prime 一次付清,remember=true 存成 card_token 供下次自動
77
81
  taiwan-payment/
78
82
  ├── SKILL.md # AI 技能主文檔
79
83
  ├── EXAMPLES.md # 實戰範例集
80
- ├── references/ # 10 份 API 規格 (~9,200 行)
84
+ ├── references/ # 各服務商 API 規格
81
85
  │ ├── ecpay-payment-api.md
82
86
  │ ├── newebpay-payment-api.md
83
87
  │ ├── payuni-payment-api.md
84
- │ ├── smilepay-payment-api.md # 反推 Mid_smilepay 加權檢核碼
88
+ │ ├── smilepay-payment-api.md # Mid_smilepay 加權檢核碼
85
89
  │ ├── pchomepay-payment-api.md # 含 8h token 流程
86
90
  │ ├── ezpay-payment-api.md # 電子支付平台 + 跨境(依官方手冊)
87
91
  │ ├── paynow-payment-api.md # 雙 API 並行
88
92
  │ ├── shopline-payment-api.md # Redirect + Embedded
89
93
  │ ├── linepay-payment-api.md # HMAC + Preapproved
90
- │ └── tappay-payment-api.md # Prime + Token 重複扣款
91
- ├── examples/ # 10 個生產級 Python 範例
92
- └── data/ # 7 份 CSV
93
- ├── providers.csv # 10 服務商完整比較
94
- ├── operations.csv # 26 個 API 操作
95
- ├── payment-methods.csv # 25+ 支付方式對照
96
- ├── error-codes.csv # 130+ 錯誤碼
94
+ │ ├── tappay-payment-api.md # Prime + Token 重複扣款
95
+ │ ├── opay-payment-api.md
96
+ │ ├── jkopay-payment-api.md
97
+ │ ├── sunpay-payment-api.md
98
+ │ ├── gomypay-payment-api.md
99
+ │ └── twqr-ewallet-landscape.md # 電子支付/TWQR 生態
100
+ ├── examples/ # 可執行 Python 範例
101
+ └── data/ # search / recommend 使用的 CSV
102
+ ├── providers.csv
103
+ ├── operations.csv
104
+ ├── payment-methods.csv
105
+ ├── error-codes.csv # 各家官方錯誤碼
97
106
  └── ...
98
107
  ```
99
108
 
@@ -109,14 +118,14 @@ taiwan-payment init --global # 全域安裝
109
118
 
110
119
  ## 14 個 AI 平台支援
111
120
 
112
- Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Codex · Qoder · Roo Code · Gemini · Trae · OpenCode · Continue · CodeBuddy
121
+ Claude Code · Cursor · Windsurf · Antigravity · GitHub Copilot · Kiro · Codex · Qoder · Cline · Gemini · Trae · OpenCode · Continue · CodeBuddy
113
122
 
114
123
  ## 相關套件
115
124
 
116
125
  本套件是 **[Taiwan E-Commerce Toolkit](https://github.com/Moksa1123/taiwan-ecommerce-toolkit)** 的一部分:
117
126
 
118
- - [taiwan-invoice-skill](https://www.npmjs.com/package/taiwan-invoice-skill) — 5 家電子發票
119
- - [taiwan-logistics-skill](https://www.npmjs.com/package/taiwan-logistics-skill) — 7 家物流(含 HCT 直連)
127
+ - [taiwan-invoice-skill](https://www.npmjs.com/package/taiwan-invoice-skill) — 7 家電子發票加值中心 + 財政部大平台查詢
128
+ - [taiwan-logistics-skill](https://www.npmjs.com/package/taiwan-logistics-skill) — 7 家物流 aggregator + HCT 直連 + 3 家即時配送
120
129
 
121
130
  ## 授權
122
131
 
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  name: taiwan-payment
3
- description: Taiwan Payment API integration specialist for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay v4, and TapPay payment gateways. Use when developing payment systems, implementing credit card, ATM, CVS, e-wallet, LINE Pay, Apple Pay, Google Pay, or BNPL payments, or working with Taiwan payment gateway APIs. Handles encryption (SHA256, AES-256-CBC, AES-256-GCM, dynamic AES-256, JWT, HMAC-SHA256, Basic Auth → token, Prime token), API requests, and service provider differences.
3
+ description: Taiwan Payment API integration specialist for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay v4, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay. Use when developing payment systems, implementing credit card, ATM, CVS, e-wallet, LINE Pay, Apple Pay, Google Pay, TWQR or BNPL payments, or working with Taiwan payment gateway APIs. Handles encryption (SHA256, AES-256-CBC, AES-256-GCM, dynamic AES-256, RSA, JWT, HMAC-SHA256, Basic Auth → token, Prime token), API requests, and service provider differences.
4
4
  user-invocable: true
5
5
  ---
6
6
 
7
7
  # Taiwan Payment Development Skill
8
8
 
9
- > 此技能涵蓋台灣金流 API 整合開發,包含綠界 (ECPay)、藍新 (NewebPay)、統一 (PAYUNi)、速買配 (SmilePay)、拍錢包 (PChomePay)、ezPay 簡單付、立吉富 (PayNow)、SHOPLINE Payments、LINE Pay v4、TapPay 共十家服務商。
9
+ > 此技能涵蓋台灣金流 API 整合開發,包含綠界 (ECPay)、藍新 (NewebPay)、統一 (PAYUNi)、速買配 (SmilePay)、拍錢包 (PChomePay)、ezPay 簡單付、立吉富 (PayNow)、SHOPLINE Payments、LINE Pay v4、TapPay、歐付寶 (O'Pay)、街口 (JKOPAY)、紅陽 (SunPay)、GoMyPay 共 14 家服務商。
10
10
 
11
11
  ## 快速導覽
12
12
 
@@ -22,12 +22,17 @@ user-invocable: true
22
22
  - `references/shopline-payment-api.md` - Shopline Payments API 規格(Redirect + Embedded SDK 雙模式)
23
23
  - `references/linepay-payment-api.md` - LINE Pay v4 API 規格(HMAC-SHA256 + Preapproved Pay)
24
24
  - `references/tappay-payment-api.md` - TapPay API 規格(Prime 兩段式 / PCI 隔離 / pay-by-token 重複扣款)
25
+ - `references/opay-payment-api.md` - 歐付寶 O'Pay 全方位金流(與 ECPay 同源的 CheckMacValue 架構)
26
+ - `references/jkopay-payment-api.md` - 街口支付 JKOPAY(線上支付 / POS / 授權扣款,三套簽章並存)
27
+ - `references/sunpay-payment-api.md` - 紅陽 SunPay(RSA 分段加密 + SHA256 check_value)
28
+ - `references/gomypay-payment-api.md` - GoMyPay(完整 API 須洽客服,參數待補)
29
+ - `references/twqr-ewallet-landscape.md` - 電子支付/行動支付生態與 TWQR:全支付、悠遊付等要怎麼收
25
30
  - [EXAMPLES.md](EXAMPLES.md) - 程式碼範例集
26
31
 
27
32
  ### 智能工具
28
33
  - `scripts/search.py` - BM25 搜索引擎(查詢 API、錯誤碼、欄位映射、付款方式)
29
34
  - `scripts/recommend.py` - 金流服務商推薦系統
30
- - `scripts/test_payment.py` - 付款測試工具
35
+ - `scripts/test_payment.py` - 已知答案測試 + 測試環境連線
31
36
  - `data/` - CSV 數據檔(providers, operations, error-codes, field-mappings, payment-methods, troubleshooting, reasoning)
32
37
 
33
38
  ### 何時使用此技能
@@ -865,15 +870,12 @@ HashIV: 請至後台申請
865
870
  ## 參考資料
866
871
 
867
872
  詳細 API 規格請查看 `references/` 目錄:
868
- - [綠界 ECPay Payment API 規格](./references/ECPAY_PAYMENT_REFERENCE.md)
869
- - [藍新 NewebPay Payment API 規格](./references/NEWEBPAY_PAYMENT_REFERENCE.md)
870
- - [統一 PAYUNi Payment API 規格](./references/PAYUNI_PAYMENT_REFERENCE.md)
873
+ - [綠界 ECPay Payment API 規格](./references/ecpay-payment-api.md)
874
+ - [藍新 NewebPay Payment API 規格](./references/newebpay-payment-api.md)
875
+ - [統一 PAYUNi Payment API 規格](./references/payuni-payment-api.md)
871
876
 
872
877
  官方文檔:
873
878
  - ECPay: https://developers.ecpay.com.tw/
874
879
  - NewebPay: https://www.newebpay.com/website/Page/content/download_api
875
880
  - PAYUNi: https://www.payuni.com.tw/docs/
876
881
 
877
- ---
878
-
879
- 最後更新:2026/01/29