taiwan-payment-skill 1.5.4 → 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 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,14 +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
 
@@ -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,9 +870,9 @@ 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/
@@ -55,8 +55,8 @@ CSV_CONFIG = {
55
55
  },
56
56
  'payment_method': {
57
57
  'file': 'payment-methods.csv',
58
- 'search_cols': ['method_id', 'name_zh', 'name_en', 'ecpay_code', 'newebpay_code', 'payuni_code', 'description', 'features'],
59
- 'output_cols': ['method_id', 'name_zh', 'ecpay_code', 'newebpay_code', 'payuni_code', 'category', 'description', 'features']
58
+ 'search_cols': ['method_code', 'method_zh', 'method_en', 'ecpay_code', 'newebpay_code', 'payuni_code', 'opay_code', 'smilepay_code', 'pchomepay_code', 'ezpay_code', 'paynow_code', 'sunpay_code', 'notes'],
59
+ 'output_cols': ['method_code', 'method_zh', 'ecpay_code', 'newebpay_code', 'payuni_code', 'opay_code', 'smilepay_code', 'pchomepay_code', 'ezpay_code', 'paynow_code', 'sunpay_code', 'min_amount', 'max_amount', 'settlement_days', 'notes']
60
60
  },
61
61
  'troubleshoot': {
62
62
  'file': 'troubleshooting.csv',
@@ -114,8 +114,10 @@ def format_all_results_ascii(all_results: Dict[str, List]) -> str:
114
114
  output.append(f' 錯誤碼: {result.get("code", "")} - {result.get("message_zh", "")}')
115
115
  output.append(f' 解決: {result.get("solution", "")}')
116
116
  elif domain == 'payment_method':
117
- output.append(f' 方式: {result.get("name_zh", "")}')
118
- output.append(f' 說明: {result.get("description", "")}')
117
+ output.append(f' 方式: {result.get("method_zh", "")}({result.get("method_code", "")})')
118
+ codes = [f'{k[:-5]}={v}' for k, v in result.items() if k.endswith('_code') and k != 'method_code' and v]
119
+ output.append(f' 代碼: {", ".join(codes)}')
120
+ output.append(f' 說明: {result.get("notes", "")}')
119
121
  else:
120
122
  # 顯示前 3 個欄位
121
123
  for key, value in list(result.items())[:3]:
@@ -2,7 +2,7 @@
2
2
 
3
3
  Reference these guidelines when:
4
4
  - Developing Taiwan Payment Gateway integration
5
- - Integrating ECPay, NewebPay, or PAYUNi payment APIs
5
+ - Integrating ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay or GoMyPay
6
6
  - Implementing credit card, ATM virtual account, CVS code, or e-wallet payments
7
7
  - Verifying CheckMacValue / TradeSha / EncryptInfo signatures
8
8
  - Troubleshooting payment callbacks, refund flows, or 3D Secure
@@ -44,8 +44,7 @@ Reference these guidelines when:
44
44
 
45
45
  ### 4. Refund Flow (MEDIUM)
46
46
 
47
- - `partial-refund` - Most providers support partial refund (within original amount)
48
- - `refund-window` - Each provider has a refund window (e.g., 180 days for credit card)
47
+ - `refund-rules` - 部分退款與退款期限各家不同(例:街口退款限 180 天內,用券訂單只能全額退),查該家 reference
49
48
  - `refund-status-poll` - Refunds may be async; poll status or wait for callback
50
49
 
51
50
  ### 5. Common Pitfalls
@@ -16,12 +16,17 @@
16
16
  - `references/shopline-payment-api.md` - Shopline Payments API 規格(Redirect + Embedded SDK 雙模式)
17
17
  - `references/linepay-payment-api.md` - LINE Pay v4 API 規格(HMAC-SHA256 + Preapproved Pay)
18
18
  - `references/tappay-payment-api.md` - TapPay API 規格(Prime 兩段式 / PCI 隔離 / pay-by-token 重複扣款)
19
+ - `references/opay-payment-api.md` - 歐付寶 O'Pay 全方位金流(與 ECPay 同源的 CheckMacValue 架構)
20
+ - `references/jkopay-payment-api.md` - 街口支付 JKOPAY(線上支付 / POS / 授權扣款,三套簽章並存)
21
+ - `references/sunpay-payment-api.md` - 紅陽 SunPay(RSA 分段加密 + SHA256 check_value)
22
+ - `references/gomypay-payment-api.md` - GoMyPay(完整 API 須洽客服,參數待補)
23
+ - `references/twqr-ewallet-landscape.md` - 電子支付/行動支付生態與 TWQR:全支付、悠遊付等要怎麼收
19
24
  - [EXAMPLES.md](EXAMPLES.md) - 程式碼範例集
20
25
 
21
26
  ### 智能工具
22
27
  - `scripts/search.py` - BM25 搜索引擎(查詢 API、錯誤碼、欄位映射、付款方式)
23
28
  - `scripts/recommend.py` - 金流服務商推薦系統
24
- - `scripts/test_payment.py` - 付款測試工具
29
+ - `scripts/test_payment.py` - 已知答案測試 + 測試環境連線
25
30
  - `data/` - CSV 數據檔(providers, operations, error-codes, field-mappings, payment-methods, troubleshooting, reasoning)
26
31
 
27
32
  ### 何時使用此技能
@@ -859,9 +864,9 @@ HashIV: 請至後台申請
859
864
  ## 參考資料
860
865
 
861
866
  詳細 API 規格請查看 `references/` 目錄:
862
- - [綠界 ECPay Payment API 規格](./references/ECPAY_PAYMENT_REFERENCE.md)
863
- - [藍新 NewebPay Payment API 規格](./references/NEWEBPAY_PAYMENT_REFERENCE.md)
864
- - [統一 PAYUNi Payment API 規格](./references/PAYUNI_PAYMENT_REFERENCE.md)
867
+ - [綠界 ECPay Payment API 規格](./references/ecpay-payment-api.md)
868
+ - [藍新 NewebPay Payment API 規格](./references/newebpay-payment-api.md)
869
+ - [統一 PAYUNi Payment API 規格](./references/payuni-payment-api.md)
865
870
 
866
871
  官方文檔:
867
872
  - ECPay: https://developers.ecpay.com.tw/
@@ -11,7 +11,7 @@
11
11
  "scriptPath": "skills/taiwan-payment/scripts",
12
12
  "frontmatter": {
13
13
  "name": "taiwan-payment",
14
- "description": "Taiwan Payment API integration specialist for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay payment gateways. Use when developing payment systems, implementing credit card, ATM, CVS, or e-wallet payments, or working with Taiwan payment gateway APIs. Handles encryption (SHA256, AES-256-CBC, AES-256-GCM, JWT, Basic Auth), API requests, and service provider differences.",
14
+ "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.",
15
15
  "user-invocable": "true"
16
16
  },
17
17
  "sections": {
@@ -21,6 +21,6 @@
21
21
  "quickReference": false
22
22
  },
23
23
  "title": "Taiwan Payment Skill",
24
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
24
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
25
25
  "skillOrWorkflow": "Skill"
26
26
  }
@@ -11,7 +11,7 @@
11
11
  "scriptPath": "skills/taiwan-payment/scripts",
12
12
  "frontmatter": {
13
13
  "name": "taiwan-payment",
14
- "description": "Taiwan Payment API integration specialist for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay payment gateways. Use when developing payment systems, implementing credit card, ATM, CVS, or e-wallet payments, or working with Taiwan payment gateway APIs. Handles encryption (SHA256, AES-256-CBC, AES-256-GCM, JWT, Basic Auth), API requests, and service provider differences.",
14
+ "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.",
15
15
  "user-invocable": "true"
16
16
  },
17
17
  "sections": {
@@ -21,6 +21,6 @@
21
21
  "quickReference": true
22
22
  },
23
23
  "title": "Taiwan Payment Skill",
24
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
24
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
25
25
  "skillOrWorkflow": "Skill"
26
26
  }
@@ -8,10 +8,10 @@
8
8
  "filename": "SKILL.md",
9
9
  "globalRoot": "~/.cline"
10
10
  },
11
- "scriptPath": "commands/taiwan-payment/scripts",
11
+ "scriptPath": "skills/taiwan-payment/scripts",
12
12
  "frontmatter": {
13
13
  "name": "taiwan-payment",
14
- "description": "Taiwan Payment API integration for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay.",
14
+ "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.",
15
15
  "user-invocable": "true"
16
16
  },
17
17
  "sections": {
@@ -21,6 +21,6 @@
21
21
  "quickReference": false
22
22
  },
23
23
  "title": "Taiwan Payment Skill",
24
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
24
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
25
25
  "skillOrWorkflow": "Skill"
26
26
  }
@@ -10,7 +10,7 @@
10
10
  "scriptPath": "skills/taiwan-payment/scripts",
11
11
  "frontmatter": {
12
12
  "name": "taiwan-payment",
13
- "description": "Taiwan Payment API integration for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay.",
13
+ "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.",
14
14
  "user-invocable": "true"
15
15
  },
16
16
  "sections": {
@@ -20,6 +20,6 @@
20
20
  "quickReference": false
21
21
  },
22
22
  "title": "Taiwan Payment Skill",
23
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
23
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
24
24
  "skillOrWorkflow": "Skill"
25
25
  }
@@ -11,7 +11,7 @@
11
11
  "scriptPath": "skills/taiwan-payment/scripts",
12
12
  "frontmatter": {
13
13
  "name": "taiwan-payment",
14
- "description": "Taiwan Payment API integration for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay.",
14
+ "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.",
15
15
  "user-invocable": "true"
16
16
  },
17
17
  "sections": {
@@ -21,6 +21,6 @@
21
21
  "quickReference": false
22
22
  },
23
23
  "title": "Taiwan Payment Skill",
24
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
24
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
25
25
  "skillOrWorkflow": "Skill"
26
26
  }
@@ -10,7 +10,7 @@
10
10
  "scriptPath": "skills/taiwan-payment/scripts",
11
11
  "frontmatter": {
12
12
  "name": "taiwan-payment",
13
- "description": "Taiwan Payment API integration for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay.",
13
+ "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.",
14
14
  "user-invocable": "true"
15
15
  },
16
16
  "sections": {
@@ -20,6 +20,6 @@
20
20
  "quickReference": false
21
21
  },
22
22
  "title": "Taiwan Payment Skill",
23
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
23
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
24
24
  "skillOrWorkflow": "Skill"
25
25
  }
@@ -7,10 +7,10 @@
7
7
  "skillPath": "skills/taiwan-payment",
8
8
  "filename": "SKILL.md"
9
9
  },
10
- "scriptPath": "prompts/taiwan-payment/scripts",
10
+ "scriptPath": "skills/taiwan-payment/scripts",
11
11
  "frontmatter": {
12
12
  "name": "taiwan-payment",
13
- "description": "Taiwan Payment API integration for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay.",
13
+ "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.",
14
14
  "user-invocable": "true"
15
15
  },
16
16
  "sections": {
@@ -20,6 +20,6 @@
20
20
  "quickReference": false
21
21
  },
22
22
  "title": "Taiwan Payment Skill",
23
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
23
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
24
24
  "skillOrWorkflow": "Skill"
25
25
  }
@@ -11,7 +11,7 @@
11
11
  "scriptPath": "skills/taiwan-payment/scripts",
12
12
  "frontmatter": {
13
13
  "name": "taiwan-payment",
14
- "description": "Taiwan Payment API integration specialist for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay payment gateways. Use when developing payment systems, implementing credit card, ATM, CVS, or e-wallet payments, or working with Taiwan payment gateway APIs. Handles encryption (SHA256, AES-256-CBC, AES-256-GCM, JWT, Basic Auth), API requests, and service provider differences.",
14
+ "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.",
15
15
  "user-invocable": "true"
16
16
  },
17
17
  "sections": {
@@ -21,6 +21,6 @@
21
21
  "quickReference": false
22
22
  },
23
23
  "title": "Taiwan Payment Skill",
24
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
24
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
25
25
  "skillOrWorkflow": "Skill"
26
26
  }
@@ -10,7 +10,7 @@
10
10
  "scriptPath": "skills/taiwan-payment/scripts",
11
11
  "frontmatter": {
12
12
  "name": "taiwan-payment",
13
- "description": "Taiwan Payment API integration for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay.",
13
+ "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.",
14
14
  "user-invocable": "true"
15
15
  },
16
16
  "sections": {
@@ -20,6 +20,6 @@
20
20
  "quickReference": false
21
21
  },
22
22
  "title": "Taiwan Payment Skill",
23
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
23
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
24
24
  "skillOrWorkflow": "Skill"
25
25
  }
@@ -7,10 +7,10 @@
7
7
  "skillPath": "skills/taiwan-payment",
8
8
  "filename": "SKILL.md"
9
9
  },
10
- "scriptPath": "steering/taiwan-payment/scripts",
10
+ "scriptPath": "skills/taiwan-payment/scripts",
11
11
  "frontmatter": {
12
12
  "name": "taiwan-payment",
13
- "description": "Taiwan Payment API integration for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay.",
13
+ "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.",
14
14
  "user-invocable": "true"
15
15
  },
16
16
  "sections": {
@@ -20,6 +20,6 @@
20
20
  "quickReference": false
21
21
  },
22
22
  "title": "Taiwan Payment Skill",
23
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
23
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
24
24
  "skillOrWorkflow": "Skill"
25
25
  }
@@ -10,7 +10,7 @@
10
10
  "scriptPath": "skills/taiwan-payment/scripts",
11
11
  "frontmatter": {
12
12
  "name": "taiwan-payment",
13
- "description": "Taiwan Payment API integration for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay.",
13
+ "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.",
14
14
  "user-invocable": "true"
15
15
  },
16
16
  "sections": {
@@ -20,6 +20,6 @@
20
20
  "quickReference": false
21
21
  },
22
22
  "title": "Taiwan Payment Skill",
23
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
23
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
24
24
  "skillOrWorkflow": "Skill"
25
25
  }
@@ -10,7 +10,7 @@
10
10
  "scriptPath": "skills/taiwan-payment/scripts",
11
11
  "frontmatter": {
12
12
  "name": "taiwan-payment",
13
- "description": "Taiwan Payment API integration for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay.",
13
+ "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.",
14
14
  "user-invocable": "true"
15
15
  },
16
16
  "sections": {
@@ -20,6 +20,6 @@
20
20
  "quickReference": false
21
21
  },
22
22
  "title": "Taiwan Payment Skill",
23
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
23
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
24
24
  "skillOrWorkflow": "Skill"
25
25
  }
@@ -10,7 +10,7 @@
10
10
  "scriptPath": "skills/taiwan-payment/scripts",
11
11
  "frontmatter": {
12
12
  "name": "taiwan-payment",
13
- "description": "Taiwan Payment API integration for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay.",
13
+ "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.",
14
14
  "user-invocable": "true"
15
15
  },
16
16
  "sections": {
@@ -20,6 +20,6 @@
20
20
  "quickReference": false
21
21
  },
22
22
  "title": "Taiwan Payment Skill",
23
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
23
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
24
24
  "skillOrWorkflow": "Skill"
25
25
  }
@@ -10,7 +10,7 @@
10
10
  "scriptPath": "skills/taiwan-payment/scripts",
11
11
  "frontmatter": {
12
12
  "name": "taiwan-payment",
13
- "description": "Taiwan Payment API integration specialist for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay payment gateways. Use when developing payment systems, implementing credit card, ATM, CVS, or e-wallet payments, or working with Taiwan payment gateway APIs. Handles encryption (SHA256, AES-256-CBC, AES-256-GCM, JWT, Basic Auth), API requests, and service provider differences.",
13
+ "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.",
14
14
  "user-invocable": "true"
15
15
  },
16
16
  "sections": {
@@ -20,6 +20,6 @@
20
20
  "quickReference": false
21
21
  },
22
22
  "title": "Taiwan Payment Skill",
23
- "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay providers with credit card, ATM, CVS, and e-wallet payment operations.",
23
+ "description": "Comprehensive guide for Taiwan Payment Gateway API integration. Supports ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay with credit card, ATM, CVS, and e-wallet payment operations.",
24
24
  "skillOrWorkflow": "Skill"
25
25
  }
package/dist/index.js CHANGED
@@ -15907,6 +15907,12 @@ async function copyTaiwanPaymentAssets(targetSkillDir, sections) {
15907
15907
  if (sections.examples && await exists((0, import_node_path.join)(sourceDir, "EXAMPLES.md"))) {
15908
15908
  await (0, import_promises.cp)((0, import_node_path.join)(sourceDir, "EXAMPLES.md"), (0, import_node_path.join)(targetSkillDir, "EXAMPLES.md"));
15909
15909
  }
15910
+ if (sections.examples && await exists((0, import_node_path.join)(sourceDir, "examples"))) {
15911
+ await (0, import_promises.cp)((0, import_node_path.join)(sourceDir, "examples"), (0, import_node_path.join)(targetSkillDir, "examples"), {
15912
+ recursive: true,
15913
+ filter: (src) => !src.includes("__pycache__")
15914
+ });
15915
+ }
15910
15916
  if (sections.references && await exists((0, import_node_path.join)(sourceDir, "references"))) {
15911
15917
  const refsTarget = (0, import_node_path.join)(targetSkillDir, "references");
15912
15918
  await (0, import_promises.mkdir)(refsTarget, { recursive: true });
@@ -15917,7 +15923,7 @@ async function copyTaiwanPaymentAssets(targetSkillDir, sections) {
15917
15923
  await (0, import_promises.mkdir)(scriptsTarget, { recursive: true });
15918
15924
  await (0, import_promises.cp)((0, import_node_path.join)(sourceDir, "scripts"), scriptsTarget, { recursive: true });
15919
15925
  }
15920
- if (sections.data && await exists((0, import_node_path.join)(sourceDir, "data"))) {
15926
+ if ((sections.scripts || sections.data) && await exists((0, import_node_path.join)(sourceDir, "data"))) {
15921
15927
  const dataTarget = (0, import_node_path.join)(targetSkillDir, "data");
15922
15928
  await (0, import_promises.mkdir)(dataTarget, { recursive: true });
15923
15929
  await (0, import_promises.cp)((0, import_node_path.join)(sourceDir, "data"), dataTarget, { recursive: true });
@@ -16350,38 +16356,32 @@ function listCommand() {
16350
16356
 
16351
16357
  // src/commands/info.ts
16352
16358
  var import_chalk5 = __toESM(require_source());
16353
- function infoCommand() {
16359
+
16360
+ // src/version.ts
16361
+ var VERSION = "1.5.5";
16362
+
16363
+ // src/commands/info.ts
16364
+ async function infoCommand() {
16354
16365
  logger.title("Taiwan Payment Skill");
16355
- console.log(import_chalk5.default.cyan("Description:"));
16356
- console.log(import_chalk5.default.dim(" AI-powered toolkit for Taiwan payment gateway integration"));
16357
- console.log();
16358
- console.log(import_chalk5.default.cyan("Supported Providers:"));
16359
- console.log(import_chalk5.default.dim(" \u2022 ECPay (\u7DA0\u754C\u79D1\u6280) - Full support"));
16360
- console.log(import_chalk5.default.dim(" \u2022 NewebPay (\u85CD\u65B0\u91D1\u6D41) - Planned"));
16361
- console.log(import_chalk5.default.dim(" \u2022 PAYUNi (\u7D71\u4E00\u91D1\u6D41) - Planned"));
16362
- console.log();
16363
- console.log(import_chalk5.default.cyan("Payment Methods:"));
16364
- console.log(import_chalk5.default.dim(" \u2022 Credit Card (one-time, installment, recurring)"));
16365
- console.log(import_chalk5.default.dim(" \u2022 ATM Virtual Account"));
16366
- console.log(import_chalk5.default.dim(" \u2022 CVS Code / Barcode"));
16367
- console.log(import_chalk5.default.dim(" \u2022 Apple Pay / TWQR / BNPL"));
16366
+ console.log(import_chalk5.default.cyan("Skill Information:"));
16368
16367
  console.log();
16369
- console.log(import_chalk5.default.cyan("Features:"));
16370
- console.log(import_chalk5.default.dim(" \u2022 Complete API documentation"));
16371
- console.log(import_chalk5.default.dim(" \u2022 Multi-language code examples (PHP, Python, Node.js, C#)"));
16372
- console.log(import_chalk5.default.dim(" \u2022 Error handling guides"));
16373
- console.log(import_chalk5.default.dim(" \u2022 Test connection scripts"));
16368
+ console.log(` ${import_chalk5.default.dim("Name:")} taiwan-payment`);
16369
+ console.log(` ${import_chalk5.default.dim("Version:")} ${VERSION}`);
16370
+ console.log(` ${import_chalk5.default.dim("Providers:")} ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, TapPay, O'Pay, JKOPAY, SunPay, GoMyPay`);
16371
+ console.log(` ${import_chalk5.default.dim("Features:")} Checkout, Callback verification, Query, Refund, Recurring`);
16372
+ console.log(` ${import_chalk5.default.dim("Platforms:")} 14 AI assistants (Claude, Cursor, Windsurf, Copilot, etc.)`);
16373
+ console.log(` ${import_chalk5.default.dim("License:")} MIT`);
16374
16374
  console.log();
16375
16375
  console.log(import_chalk5.default.cyan("Links:"));
16376
- console.log(import_chalk5.default.dim(" GitHub: https://github.com/Moksa1123/taiwan-ecommerce-toolkit"));
16377
- console.log(import_chalk5.default.dim(" npm: https://www.npmjs.com/package/taiwan-payment-skill"));
16376
+ console.log(` ${import_chalk5.default.dim("GitHub:")} https://github.com/Moksa1123/taiwan-ecommerce-toolkit`);
16377
+ console.log(` ${import_chalk5.default.dim("npm:")} https://www.npmjs.com/package/taiwan-payment-skill`);
16378
+ console.log(` ${import_chalk5.default.dim("Support:")} https://paypal.me/cccsubcom`);
16378
16379
  console.log();
16379
16380
  }
16380
16381
 
16381
16382
  // src/commands/versions.ts
16382
16383
  var import_chalk6 = __toESM(require_source());
16383
16384
  var import_ora = __toESM(require_ora());
16384
- var VERSION = "1.0.0";
16385
16385
  async function versionsCommand() {
16386
16386
  logger.title("Taiwan Payment Skill - Available Versions");
16387
16387
  const spinner = (0, import_ora.default)("Fetching versions from npm...").start();
@@ -16424,11 +16424,10 @@ async function versionsCommand() {
16424
16424
  // src/commands/update.ts
16425
16425
  var import_chalk7 = __toESM(require_source());
16426
16426
  var import_ora2 = __toESM(require_ora());
16427
- var VERSION2 = "1.0.0";
16428
16427
  async function updateCommand() {
16429
16428
  logger.title("Taiwan Payment Skill - Update");
16430
16429
  console.log(import_chalk7.default.cyan("Current Version:"));
16431
- console.log(import_chalk7.default.dim(` ${VERSION2}`));
16430
+ console.log(import_chalk7.default.dim(` ${VERSION}`));
16432
16431
  console.log();
16433
16432
  const spinner = (0, import_ora2.default)("Checking for updates...").start();
16434
16433
  try {
@@ -16442,7 +16441,7 @@ async function updateCommand() {
16442
16441
  }
16443
16442
  const data = await response.json();
16444
16443
  const latestVersion = data.version;
16445
- if (latestVersion === VERSION2) {
16444
+ if (latestVersion === VERSION) {
16446
16445
  spinner.succeed("You are already on the latest version!");
16447
16446
  } else {
16448
16447
  spinner.info(`New version available: ${latestVersion}`);
@@ -16460,9 +16459,8 @@ async function updateCommand() {
16460
16459
  }
16461
16460
 
16462
16461
  // src/index.ts
16463
- var VERSION3 = "1.0.0";
16464
16462
  var program2 = new Command();
16465
- program2.name("taiwan-payment").description("CLI to install Taiwan Payment skill for AI coding assistants").version(VERSION3);
16463
+ program2.name("taiwan-payment").description("CLI to install Taiwan Payment skill for AI coding assistants").version(VERSION);
16466
16464
  program2.command("init").description("Install Taiwan Payment skill to current project").option("-a, --ai <type>", `AI assistant type (${AI_TYPES.join(", ")})`).option("-f, --force", "Overwrite existing files").option("-g, --global", "Install to global directory").action(async (options) => {
16467
16465
  if (options.ai && !AI_TYPES.includes(options.ai)) {
16468
16466
  console.error(`Invalid AI type: ${options.ai}`);
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "taiwan-payment-skill",
3
- "version": "1.5.4",
4
- "description": "AI-powered Taiwan Payment Gateway toolkit. Supports 10 providers: ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay v4, and TapPay.",
3
+ "version": "1.5.5",
4
+ "description": "AI-powered Taiwan Payment Gateway toolkit. Supports 14 providers: ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline Payments, LINE Pay v4, TapPay, O'Pay, JKOPAY, SunPay and GoMyPay.",
5
5
  "keywords": [
6
6
  "taiwan",
7
7
  "payment",
@@ -1,25 +0,0 @@
1
- {
2
- "platform": "antigravity",
3
- "displayName": "Antigravity",
4
- "installType": "full",
5
- "folderStructure": {
6
- "root": ".agent",
7
- "skillPath": "skills/taiwan-payment",
8
- "filename": "SKILL.md",
9
- "globalRoot": "~/.agent"
10
- },
11
- "frontmatter": {
12
- "name": "taiwan-payment",
13
- "description": "Taiwan Payment API integration specialist for ECPay, NewebPay, PAYUNi, SmilePay, PChomePay, ezPay, PayNow, Shopline, LINE Pay, and TapPay payment gateways. Use when developing payment systems, implementing credit card, ATM, CVS, or e-wallet payments, or working with Taiwan payment gateway APIs. Handles encryption (SHA256, AES-256-CBC, AES-256-GCM, JWT, Basic Auth), API requests, and service provider differences.",
14
- "user-invocable": "true"
15
- },
16
- "sections": {
17
- "examples": true,
18
- "references": true,
19
- "scripts": true,
20
- "quickReference": false
21
- },
22
- "title": "Taiwan Payment Development Skill",
23
- "description": "Comprehensive guide for Taiwan Payment Gateway integration (ECPay, NewebPay, PAYUNi)",
24
- "skillOrWorkflow": "Skill"
25
- }