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.
- package/README.md +26 -17
- package/assets/taiwan-payment/CLAUDE.md +26 -23
- package/assets/taiwan-payment/EXAMPLES.md +1 -5
- package/assets/taiwan-payment/README.md +25 -16
- package/assets/taiwan-payment/SKILL.md +11 -9
- package/assets/taiwan-payment/data/error-codes.csv +1628 -4
- package/assets/taiwan-payment/data/payment-methods.csv +6 -6
- package/assets/taiwan-payment/examples/ecpay-payment-example.py +1 -2
- package/assets/taiwan-payment/examples/ezpay-payment-example.py +0 -2
- package/assets/taiwan-payment/examples/jkopay-payment-example.py +13 -15
- package/assets/taiwan-payment/examples/linepay-payment-example.py +2 -5
- package/assets/taiwan-payment/examples/newebpay-payment-example.py +0 -1
- package/assets/taiwan-payment/examples/paynow-payment-example.py +3 -4
- package/assets/taiwan-payment/examples/payuni-payment-example.py +2 -2
- package/assets/taiwan-payment/examples/pchomepay-payment-example.py +0 -1
- package/assets/taiwan-payment/examples/shopline-payment-example.py +0 -1
- package/assets/taiwan-payment/examples/smilepay-payment-example.py +0 -1
- package/assets/taiwan-payment/examples/sunpay-payment-example.py +14 -16
- package/assets/taiwan-payment/examples/tappay-payment-example.py +0 -1
- package/assets/taiwan-payment/references/ecpay-payment-api.md +0 -2
- package/assets/taiwan-payment/references/ezpay-payment-api.md +0 -4
- package/assets/taiwan-payment/references/gomypay-payment-api.md +1 -2
- package/assets/taiwan-payment/references/jkopay-payment-api.md +2 -9
- package/assets/taiwan-payment/references/linepay-payment-api.md +2 -6
- package/assets/taiwan-payment/references/opay-payment-api.md +1 -1
- package/assets/taiwan-payment/references/paynow-payment-api.md +0 -3
- package/assets/taiwan-payment/references/payuni-payment-api.md +1 -3
- package/assets/taiwan-payment/references/pchomepay-payment-api.md +0 -3
- package/assets/taiwan-payment/references/shopline-payment-api.md +0 -3
- package/assets/taiwan-payment/references/smilepay-payment-api.md +1 -6
- package/assets/taiwan-payment/references/sunpay-payment-api.md +1 -2
- package/assets/taiwan-payment/references/tappay-payment-api.md +1 -5
- package/assets/taiwan-payment/references/twqr-ewallet-landscape.md +7 -11
- package/assets/taiwan-payment/scripts/core.py +3 -4
- package/assets/taiwan-payment/scripts/recommend.py +1 -2
- package/assets/taiwan-payment/scripts/search.py +4 -2
- package/assets/templates/base/quick-reference.md +2 -3
- package/assets/templates/base/skill-content.md +9 -7
- package/assets/templates/platforms/agent.json +2 -2
- package/assets/templates/platforms/claude.json +2 -2
- package/assets/templates/platforms/cline.json +3 -3
- package/assets/templates/platforms/codebuddy.json +2 -2
- package/assets/templates/platforms/codex.json +2 -2
- package/assets/templates/platforms/continue.json +2 -2
- package/assets/templates/platforms/copilot.json +3 -3
- package/assets/templates/platforms/cursor.json +2 -2
- package/assets/templates/platforms/gemini.json +2 -2
- package/assets/templates/platforms/kiro.json +3 -3
- package/assets/templates/platforms/opencode.json +2 -2
- package/assets/templates/platforms/qoder.json +2 -2
- package/assets/templates/platforms/trae.json +2 -2
- package/assets/templates/platforms/windsurf.json +2 -2
- package/dist/index.js +26 -28
- package/package.json +2 -2
- 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>
|
|
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-
|
|
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
|
-
##
|
|
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 簡單付** |
|
|
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
|
-
|
|
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/ #
|
|
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 #
|
|
88
|
+
│ ├── smilepay-payment-api.md # Mid_smilepay 加權檢核碼
|
|
85
89
|
│ ├── pchomepay-payment-api.md # 含 8h token 流程
|
|
86
|
-
│ ├── ezpay-payment-api.md #
|
|
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
|
-
│
|
|
91
|
-
├──
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
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) —
|
|
119
|
-
- [taiwan-logistics-skill](https://www.npmjs.com/package/taiwan-logistics-skill) — 7
|
|
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
|
|
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
|
-
│
|
|
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
|
|
49
|
-
│ └── test_payment.py #
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
├──
|
|
53
|
-
├──
|
|
54
|
-
├──
|
|
55
|
-
├──
|
|
56
|
-
├──
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
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
|
|
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
|
|
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>
|
|
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-
|
|
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
|
-
##
|
|
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
|
-
|
|
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/ #
|
|
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 #
|
|
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
|
-
│
|
|
91
|
-
├──
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
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 ·
|
|
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) —
|
|
119
|
-
- [taiwan-logistics-skill](https://www.npmjs.com/package/taiwan-logistics-skill) — 7
|
|
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,
|
|
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/
|
|
869
|
-
- [藍新 NewebPay Payment API 規格](./references/
|
|
870
|
-
- [統一 PAYUNi Payment API 規格](./references/
|
|
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
|