npm - taiwan-payment-skill - Versions diffs - 1.0.0 → 1.0.2 - Mend

taiwan-payment-skill 1.0.0 → 1.0.2

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 (6) hide show

package/README.md +1 -1
package/assets/taiwan-payment/README.md +197 -306
package/assets/taiwan-payment/examples/ecpay-payment-example.py +390 -0
package/assets/taiwan-payment/examples/newebpay-payment-example.py +451 -0
package/assets/taiwan-payment/examples/payuni-payment-example.py +457 -0
package/package.json +12 -10

package/README.md CHANGED Viewed

@@ -11,7 +11,7 @@
   <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>
   <img src="https://img.shields.io/badge/node-%3E%3D18-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js">
   <img src="https://img.shields.io/badge/platforms-14-blue?style=flat-square" alt="14 Platforms">
-  <a href="https://github.com/Moksa1123/taiwan-payment/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-payment?style=flat-square" alt="License"></a>
+  <a href="https://github.com/Moksa1123/taiwan-invoice/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-invoice?style=flat-square" alt="License"></a>
 </p>
 <p align="center">

package/assets/taiwan-payment/README.md CHANGED Viewed

@@ -1,306 +1,197 @@
-# Taiwan Payment Gateway Integration Toolkit
-**Professional payment gateway integration solution for Taiwan market**
-Supporting ECPay (綠界科技), NewebPay (藍新金流), and PAYUNi (統一金流) with comprehensive API documentation, intelligent tools, and production-ready code examples.
----
-## Overview
-This toolkit provides enterprise-grade integration capabilities for Taiwan's major payment gateways, featuring:
-- **Complete API Documentation**: Detailed specifications for all three providers
-- **Intelligent Search Engine**: BM25-powered search across 7 domains (API docs, error codes, field mappings, payment methods)
-- **Smart Recommendation System**: AI-driven provider selection based on business requirements
-- **Production-Ready Examples**: 9 comprehensive TypeScript/Python implementations
-- **Data-Driven Architecture**: 7 CSV datasets for easy maintenance and updates
-- **Multi-Platform Support**: Compatible with 14 AI coding assistants
----
-## Supported Payment Gateways
-| Provider | Encryption | API Style | Market Share | Status |
-|----------|-----------|-----------|--------------|--------|
-| **ECPay (綠界科技)** | SHA256 | Form POST | High | ✅ Full Support |
-| **NewebPay (藍新金流)** | AES-256-CBC + SHA256 | Form POST + AES | High | ✅ Full Support |
-| **PAYUNi (統一金流)** | AES-256-GCM + SHA256 | RESTful JSON | Medium | ✅ Full Support |
-### Technical Comparison
-| Feature | ECPay | NewebPay | PAYUNi |
-|---------|-------|----------|---------|
-| **Encryption Method** | URL Encode + SHA256 | Dual-layer (AES-256-CBC + SHA256) | AES-256-GCM + SHA256 |
-| **Content Type** | application/x-www-form-urlencoded | application/x-www-form-urlencoded | application/json |
-| **Payment Methods** | 11 types (including BNPL, TWQR) | 13 types (including LINE Pay, Apple Pay) | 8 types (including AFTEE, iCash) |
-| **API Design** | Traditional Form POST | MPG Integration, Form POST | Modern RESTful JSON |
-| **Best For** | High-volume e-commerce, Traditional industries | Multi-payment scenarios, Mobile apps | API-first startups, Modern tech stacks |
----
-## Installation
-### NPM Global Installation
-```bash
-npm install -g taiwan-payment-skill
-```
-### Initialize in Project
-```bash
-# Auto-detect AI assistant
-taiwan-payment init
-# Specify AI assistant type
-taiwan-payment init --ai claude      # Claude Code
-taiwan-payment init --ai cursor      # Cursor
-taiwan-payment init --ai windsurf    # Windsurf
-```
-### Supported AI Platforms (14)
-Claude Code · Cursor · Windsurf · GitHub Copilot · Antigravity · Kiro · Codex · Qoder · Roo Code · Gemini CLI · Trae · OpenCode · Continue · CodeBuddy
----
-## Intelligent Tools
-### 1. BM25 Search Engine
-Fast semantic search across payment gateway documentation and error codes.
-```bash
-# Search error codes
-python scripts/search.py "10100058" --domain error
-# Search payment methods
-python scripts/search.py "信用卡" --domain payment_method
-# Search field mappings
-python scripts/search.py "MerchantTradeNo" --domain field
-# JSON output
-python scripts/search.py "ATM" --format json
-```
-**Search Domains:**
-- `provider` - Provider comparison
-- `operation` - API endpoints
-- `error` - Error code lookup
-- `field` - Field name mappings
-- `payment_method` - Payment method specifications
-- `troubleshoot` - Troubleshooting guides
-- `reasoning` - Recommendation logic
-### 2. Smart Recommendation System
-AI-powered provider recommendation based on business requirements.
-```bash
-# High-volume e-commerce
-python scripts/recommend.py "高交易量 電商 穩定"
-# → Recommends ECPay (highest market share, proven stability)
-# Multi-payment requirements
-python scripts/recommend.py "多元支付 LINE Pay Apple Pay"
-# → Recommends NewebPay (supports 13 payment methods)
-# API-first design
-python scripts/recommend.py "API RESTful JSON"
-# → Recommends PAYUNi (modern RESTful design)
-```
-### 3. Connection Testing Tool
-Verify API connectivity and credentials.
-```bash
-# Test specific provider
-python scripts/test_payment.py ecpay
-python scripts/test_payment.py newebpay
-python scripts/test_payment.py payuni
-# Test all providers
-python scripts/test_payment.py all
-```
----
-## Architecture
-```
-taiwan-payment/
-├── SKILL.md                        # Main documentation (857 lines)
-├── EXAMPLES.md                     # Code examples (1425 lines)
-├── references/                     # API specifications
-│   ├── ECPAY_PAYMENT_REFERENCE.md
-│   ├── NEWEBPAY_PAYMENT_REFERENCE.md
-│   └── PAYUNI_PAYMENT_REFERENCE.md
-├── scripts/                        # Python intelligent tools
-│   ├── core.py                     # BM25 search engine (311 lines)
-│   ├── recommend.py                # Recommendation system (373 lines)
-│   ├── search.py                   # Search CLI (150+ lines)
-│   └── test_payment.py             # Connection testing (359 lines)
-└── data/                           # Data-driven architecture (7 CSV files)
-    ├── providers.csv               # Provider details
-    ├── operations.csv              # API operations
-    ├── error-codes.csv             # Error code mappings
-    ├── field-mappings.csv          # Field name mappings
-    ├── payment-methods.csv         # Payment method specs
-    ├── reasoning.csv               # Recommendation rules (30+ scenarios)
-    └── troubleshooting.csv         # Common issues (16 cases)
-```
----
-## Payment Methods
-### Credit Card
-- One-time payment, Installments (3/6/12/18/24/30 periods)
-- Recurring billing, Credit card tokenization
-### E-Wallets
-- Apple Pay, Google Pay, Samsung Pay
-- LINE Pay, Taiwan Pay
-### Bank Transfer
-- WebATM, Virtual account (ATM)
-### Convenience Store
-- CVS payment code, CVS barcode
-### Others
-- TWQR, BNPL (Buy Now Pay Later), AFTEE, iCash
----
-## Code Examples
-### ECPay Credit Card Payment
-```typescript
-import { createPayment } from './ecpay-service';
-const order = {
-  merchantId: '3002607',
-  orderId: `ORDER${Date.now()}`,
-  amount: 1050,
-  description: 'Product Purchase',
-  returnUrl: 'https://example.com/callback',
-  paymentMethod: 'Credit'
-};
-const form = await createPayment(order);
-// Returns HTML form ready for submission
-```
-### NewebPay MPG Integration
-```typescript
-import { createPayment } from './newebpay-service';
-const order = {
-  merchantId: 'YOUR_MERCHANT_ID',
-  orderId: `ORDER${Date.now()}`,
-  amount: 2500,
-  description: 'E-commerce Order',
-  returnUrl: 'https://example.com/notify',
-  paymentMethod: 'CREDIT,VACC,CVS' // Multiple methods
-};
-const form = await createPayment(order);
-```
-### PAYUNi RESTful API
-```typescript
-import axios from 'axios';
-import { encryptPayUni } from './encryption';
-const order = {
-  MerID: 'YOUR_MERCHANT_ID',
-  MerTradeNo: `ORDER${Date.now()}`,
-  TradeAmt: 3000,
-  ProdDesc: 'Subscription Service',
-  ReturnURL: 'https://example.com/callback',
-  PayType: 'Credit'
-};
-const { encryptInfo, hashInfo } = encryptPayUni(order);
-const response = await axios.post('https://sandbox-api.payuni.com.tw/api/upp', {
-  MerID: order.MerID,
-  EncryptInfo: encryptInfo,
-  HashInfo: hashInfo
-});
-```
----
-## Data-Driven Architecture
-All business logic is stored in CSV files for easy maintenance:
-- **providers.csv**: Provider configurations (encryption, test accounts, API endpoints)
-- **operations.csv**: API operations (create, query, refund, recurring)
-- **error-codes.csv**: Error code mappings with solutions
-- **field-mappings.csv**: Field name translations across providers
-- **payment-methods.csv**: Payment method specifications
-- **reasoning.csv**: Recommendation rules (30+ business scenarios)
-- **troubleshooting.csv**: Common issues and solutions (16 cases)
----
-## Development Requirements
-- **Node.js** >= 18.0.0 (CLI tool)
-- **Python** >= 3.x (intelligent scripts, no external dependencies)
----
-## Documentation
-- [SKILL.md](./SKILL.md) - Complete skill documentation (857 lines)
-- [EXAMPLES.md](./EXAMPLES.md) - 9 production-ready code examples (1425 lines)
-- [CLAUDE.md](./CLAUDE.md) - Development guide for Claude Code
-### API References
-- [ECPay Payment API](./references/ECPAY_PAYMENT_REFERENCE.md)
-- [NewebPay Payment API](./references/NEWEBPAY_PAYMENT_REFERENCE.md)
-- [PAYUNi Payment API](./references/PAYUNI_PAYMENT_REFERENCE.md)
----
-## License
-[MIT License](https://opensource.org/licenses/MIT)
----
-## Related Projects
-- [taiwan-invoice-skill](https://github.com/Moksa1123/taiwan-invoice) - Taiwan E-Invoice integration
-- [taiwan-logistics-skill](https://github.com/Moksa1123/taiwan-logistics) - Taiwan logistics integration
----
-## Support
-- **Official Documentation**: See `references/` directory
-- **Technical Support**:
-  - ECPay: techsupport@ecpay.com.tw
-  - NewebPay: 02-2655-8938
-  - PAYUNi: 02-2747-5100
----
-<p align="center">
-  <sub>Professional toolkit by <strong>Moksa</strong></sub><br>
-  <sub>service@moksaweb.com</sub>
-</p>
-<p align="center">
-  <sub>Last updated: 2026-01-29</sub>
-</p>
+<h1 align="center">taiwan-payment-skill</h1>
+<h3 align="center">台灣金流 AI 開發技能包</h3>
+<p align="center">
+  <strong>支援 ECPay 綠界 · NewebPay 藍新 · PAYUNi 統一</strong>
+</p>
+<p align="center">
+  <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>
+  <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>
+  <img src="https://img.shields.io/badge/node-%3E%3D18-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js">
+  <img src="https://img.shields.io/badge/platforms-14-blue?style=flat-square" alt="14 Platforms">
+  <a href="https://github.com/Moksa1123/taiwan-invoice/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Moksa1123/taiwan-invoice?style=flat-square" alt="License"></a>
+</p>
+<p align="center">
+  <a href="https://paypal.me/cccsubcom"><img src="https://img.shields.io/badge/PayPal-支持開發-00457C?style=for-the-badge&logo=paypal&logoColor=white" alt="PayPal"></a>
+</p>
+---
+## 安裝
+```bash
+npm install -g taiwan-payment-skill
+```
+---
+## 使用方式
+```bash
+# 進入專案目錄
+cd /path/to/your/project
+# 選擇你的 AI 助手
+taiwan-payment init --ai claude        # Claude Code
+taiwan-payment init --ai cursor        # Cursor
+taiwan-payment init --ai windsurf      # Windsurf
+taiwan-payment init --ai copilot       # GitHub Copilot
+taiwan-payment init --ai antigravity   # Antigravity
+taiwan-payment init --ai all           # 全部安裝
+```
+<details>
+<summary>完整平台列表</summary>
+```bash
+taiwan-payment init --ai kiro          # Kiro (AWS)
+taiwan-payment init --ai codex         # Codex CLI (OpenAI)
+taiwan-payment init --ai qoder         # Qoder
+taiwan-payment init --ai roocode       # Roo Code
+taiwan-payment init --ai gemini        # Gemini CLI
+taiwan-payment init --ai trae          # Trae (ByteDance)
+taiwan-payment init --ai opencode      # OpenCode
+taiwan-payment init --ai continue      # Continue
+taiwan-payment init --ai codebuddy     # CodeBuddy (Tencent)
+```
+</details>
+---
+## 其他指令
+```bash
+taiwan-payment list         # 列出支援平台
+taiwan-payment info         # 顯示技能資訊
+taiwan-payment versions     # 列出可用版本
+taiwan-payment update       # 檢查更新
+```
+### 選項
+```bash
+taiwan-payment init --force     # 覆蓋現有檔案
+taiwan-payment init --global    # 安裝到全域目錄（所有專案共用）
+```
+### 全域安裝
+使用 `--global` 可將技能安裝到使用者目錄，讓所有專案都能使用：
+```bash
+taiwan-payment init --ai cursor --global       # ~/.cursor/skills/taiwan-payment/
+taiwan-payment init --ai claude --global       # ~/.claude/skills/taiwan-payment/
+taiwan-payment init --ai antigravity --global  # ~/.gemini/antigravity/global_skills/taiwan-payment/
+```
+---
+## 支援平台
+| 平台 | 說明 | 啟動方式 |
+|------|------|----------|
+| **Claude Code** | Anthropic 官方 CLI | `/taiwan-payment` |
+| **Cursor** | AI 程式編輯器 | `/taiwan-payment` |
+| **Windsurf** | Codeium 編輯器 | 自動 |
+| **Copilot** | GitHub Copilot | `/taiwan-payment` |
+| **Antigravity** | Google AI 助手 | `/taiwan-payment` |
+| **Kiro** | AWS AI 助手 | `/taiwan-payment` |
+| **Codex** | OpenAI CLI | 自動 |
+| **Qoder** | Qodo AI 助手 | 自動 |
+| **RooCode** | VSCode 擴充 | `/taiwan-payment` |
+| **Gemini CLI** | Google Gemini | 自動 |
+| **Trae** | ByteDance AI | 自動 |
+| **OpenCode** | 開源 AI 助手 | 自動 |
+| **Continue** | 開源 AI 助手 | 自動 |
+| **CodeBuddy** | Tencent AI | 自動 |
+---
+## 金流服務商
+| 服務商 | 加密方式 | API 風格 | 特點 |
+|--------|---------|---------|------|
+| **ECPay 綠界** | URL Encode + SHA256 | Form POST | 市佔率最高，穩定性佳 |
+| **NewebPay 藍新** | AES-256-CBC + SHA256 | Form POST + AES | 支援最多支付方式 (13 種) |
+| **PAYUNi 統一** | AES-256-GCM + SHA256 | RESTful JSON | RESTful 設計，API 現代化 |
+---
+## 付款方式支援
+### 信用卡支付
+- 一次付清、分期付款 (3/6/12/18/24 期)
+- 信用卡定期定額、信用卡記憶
+### 電子錢包
+- Apple Pay、Google Pay、Samsung Pay
+- LINE Pay、台灣 Pay
+### 轉帳支付
+- 網路 ATM、ATM 虛擬帳號
+### 超商支付
+- 超商代碼、超商條碼
+### 其他
+- TWQR、BNPL 無卡分期、AFTEE 先享後付
+---
+## 智能工具
+安裝後包含以下 Python 工具（純 Python，無需外部依賴）：
+```bash
+# BM25 搜索引擎 - 搜索錯誤碼、欄位映射、付款方式
+python scripts/search.py "10100058" --domain error
+python scripts/search.py "信用卡" --domain payment_method
+python scripts/search.py "CheckMacValue" --domain troubleshoot
+# 智能推薦系統 - 根據需求推薦金流服務商
+python scripts/recommend.py "高交易量 電商 穩定"
+python scripts/recommend.py "多元支付 LINE Pay Apple Pay"
+# 連線測試工具 - 測試 API 連線
+python scripts/test_payment.py ecpay
+python scripts/test_payment.py all
+```
+### 搜索域
+- `provider` - 服務商比較
+- `operation` - API 操作端點
+- `error` - 錯誤碼查詢
+- `field` - 欄位映射
+- `payment_method` - 付款方式
+- `troubleshoot` - 疑難排解
+- `reasoning` - 推薦決策規則
+---
+## 功能特色
+- 完整 API 文檔 (ECPay, NewebPay, PAYUNi)
+- BM25 搜索引擎 (311 行)
+- 智能推薦系統 (373 行)
+- 9 組完整代碼範例 (TypeScript/Python)
+- 7 個 CSV 數據檔 (易於維護)
+- 加密實作指南 (SHA256, AES-CBC, AES-GCM)
+- 16 個疑難排解案例
+---
+## 授權
+[MIT License](https://github.com/Moksa1123/taiwan-payment/blob/main/LICENSE)
+---
+<p align="center">
+  <sub>Made by <strong>Moksa</strong></sub><br>
+  <sub>service@moksaweb.com</sub>
+</p>