taiwan-payment-skill 1.0.0

package/assets/taiwan-payment/data/error-codes.csv

@@ -0,0 +1,20 @@
+provider,code,message_zh,message_en,category,severity,solution
+ecpay,1,交易成功,Success,success,info,
+ecpay,10100001,參數格式錯誤,Invalid Parameter,validation,error,檢查參數格式
+ecpay,10100002,商店代號不存在,Merchant Not Found,auth,error,確認 MerchantID
+ecpay,10100003,訂單編號重複,Duplicate Order,validation,error,使用唯一訂單編號
+ecpay,10100050,交易金額錯誤,Invalid Amount,validation,error,確認金額為正整數
+ecpay,10100058,CheckMacValue 錯誤,CheckMacValue Error,auth,error,重新計算檢查碼
+ecpay,10100248,交易被拒絕,Transaction Rejected,payment,error,聯繫發卡銀行
+ecpay,10100251,卡片過期,Card Expired,payment,error,確認卡片效期
+ecpay,10100252,餘額不足,Insufficient Balance,payment,error,確認額度或餘額
+ecpay,10100254,交易受限,Transaction Restricted,payment,error,聯繫發卡銀行
+ecpay,10100255,掛失卡,Lost Card,payment,error,使用其他卡片
+ecpay,10100256,偽卡,Fraudulent Card,payment,error,使用其他卡片
+ecpay,10300066,交易待確認,Pending Confirmation,payment,warning,至後台確認
+newebpay,SUCCESS,交易成功,Success,success,info,
+newebpay,TRA10001,參數錯誤,Parameter Error,validation,error,檢查參數
+newebpay,TRA10014,商店代號錯誤,Invalid Merchant,auth,error,確認商店代號
+newebpay,TRA10027,檢查碼錯誤,CheckValue Error,auth,error,重新計算檢查碼
+newebpay,TRA20001,交易失敗,Transaction Failed,payment,error,稍後重試
+newebpay,TRA20014,交易逾時,Transaction Timeout,payment,error,重新交易

package/assets/taiwan-payment/data/field-mappings.csv

@@ -0,0 +1,15 @@
+field_name,field_zh,ecpay_name,newebpay_name,payuni_name,type,required,max_length,format,notes
+merchant_id,商店代號,MerchantID,MerchantID,MerID,string,true,10,,
+order_id,訂單編號,MerchantTradeNo,MerchantOrderNo,MerTradeNo,string,true,20,英數字,需唯一
+order_date,訂單日期,MerchantTradeDate,TimeStamp,TradeTime,string,true,20,yyyy/MM/dd HH:mm:ss,
+amount,交易金額,TotalAmount,Amt,TradeAmt,integer,true,,,無小數
+description,交易描述,TradeDesc,ItemDesc,ProdDesc,string,true,200,,需 URL Encode
+item_name,商品名稱,ItemName,ItemDesc,ProdDesc,string,true,400,,多項用#分隔
+return_url,背景通知,ReturnURL,NotifyURL,NotifyURL,string,true,200,URL,
+client_back_url,前台返回,ClientBackURL,ReturnURL,ReturnURL,string,false,200,URL,
+payment_type,付款方式,ChoosePayment,PaymentType,PayType,string,true,20,,
+check_value,檢查碼,CheckMacValue,CheckValue,CheckSum,string,true,,,SHA256
+encrypt_type,加密類型,EncryptType,Version,Version,string,true,,,固定值
+trade_no,交易編號,TradeNo,TradeNo,PayUniTradeNo,string,false,20,,平台回傳
+rtn_code,回傳代碼,RtnCode,Status,Status,string,false,10,,
+rtn_msg,回傳訊息,RtnMsg,Message,Message,string,false,200,,

package/assets/taiwan-payment/data/operations.csv

@@ -0,0 +1,8 @@
+operation,operation_zh,ecpay_endpoint,newebpay_endpoint,payuni_endpoint,method,required_fields,notes
+create_order,建立訂單,/Cashier/AioCheckOut/V5,/MPG/mpg_gateway,/api/order/create,POST,"MerchantID,MerchantTradeNo,TotalAmount,TradeDesc,ItemName,ReturnURL",主要付款入口
+query_order,查詢訂單,/Cashier/QueryTradeInfo/V5,/API/QueryTradeInfo,/api/order/query,POST,"MerchantID,MerchantTradeNo,TimeStamp",查詢交易狀態
+credit_action,信用卡請退款,/CreditDetail/DoAction,/API/CreditCard/Close,/api/credit/action,POST,"MerchantID,TradeNo,Action,TotalAmount",請款/退款/取消
+query_credit,信用卡查詢,/CreditDetail/QueryTrade/V2,/API/CreditCard/TradeInfo,/api/credit/query,POST,"MerchantID,CreditRefundId",查詢信用卡交易
+periodic_create,定期定額建立,/Cashier/AioCheckOut/V5,/API/CreditCard/Period,,POST,"PeriodAmount,PeriodType,Frequency,ExecTimes",設定週期付款
+periodic_query,定期定額查詢,/Cashier/QueryCreditCardPeriodInfo,/API/CreditCard/PeriodInfo,,POST,"MerchantID,MerchantTradeNo",查詢週期付款
+periodic_action,定期定額操作,/CreditDetail/CreditCardPeriodAction,/API/CreditCard/PeriodAlter,,POST,"MerchantID,Action",取消/修改週期

package/assets/taiwan-payment/data/payment-methods.csv

@@ -0,0 +1,24 @@
+method_code,method_zh,method_en,ecpay_code,newebpay_code,payuni_code,min_amount,max_amount,settlement_days,fee_type,notes
+credit,信用卡,Credit Card,Credit,CREDIT,credit,1,,2-3,percentage,一次付清
+credit_installment,信用卡分期,Credit Installment,Credit+CreditInstallment,INST,credit_inst,1000,,依期數,percentage,"3/6/12/18/24/30期"
+credit_periodic,信用卡定期,Credit Periodic,Credit+Period,,,100,,2-3,percentage,週期扣款
+credit_red,信用卡紅利,Credit Red,CreditRed,CreditRed,,1,,2-3,percentage,紅利折抵
+unionpay,銀聯卡,UnionPay,UnionPay,UNIONPAY,,1,,2-3,percentage,需另申請
+creditae,美國運通卡,AMEX,,CREDITAE,,1,,2-3,percentage,需另申請
+webatm,網路ATM,WebATM,WebATM,WEBATM,webatm,1,49999,1,fixed,即時轉帳
+atm,ATM虛擬帳號,ATM Virtual Account,ATM,VACC,atm,1,49999,1-3,fixed,產生繳費帳號
+cvs,超商代碼,CVS Code,CVS,CVS,cvs,30,20000,1-3,fixed,至超商繳費
+barcode,超商條碼,CVS Barcode,BARCODE,BARCODE,,20,40000,1-3,fixed,產生條碼
+applepay,Apple Pay,Apple Pay,ApplePay,APPLEPAY,ApplePay,1,,2-3,percentage,需申請
+googlepay,Google Pay,Google Pay,,ANDROIDPAY,GooglePay,1,,2-3,percentage,需申請
+samsungpay,Samsung Pay,Samsung Pay,,SAMSUNGPAY,SamsungPay,1,,2-3,percentage,需申請
+linepay,LINE Pay,LINE Pay,,LINEPAY,LinePay,1,,2-3,percentage,需申請
+esunwallet,玉山 Wallet,E.SUN Wallet,,ESUNWALLET,,1,,2-3,percentage,需申請
+taiwanpay,台灣 Pay,Taiwan Pay,,TAIWANPAY,,1,49999,2-3,percentage,需申請
+bitopay,BitoPay,BitoPay,,BITOPAY,,100,49999,2-3,percentage,加密貨幣
+twqr,TWQR,TWQR,TWQR,TWQR,TWQR,1,,2-3,percentage,台灣Pay QR Code
+bnpl,無卡分期,BNPL,BNPL,,,50,300000,依方案,percentage,先買後付
+aftee,AFTEE先享後付,AFTEE,,,AFTEE,1,,2-3,percentage,PayUNi專屬
+icash,愛金卡,iCash,,,iCash,1,,2-3,percentage,PayUNi專屬
+ezpalipay,簡單付支付寶,Alipay,,EZPALIPAY,,1,,2-3,percentage,跨境支付
+ezpwechat,簡單付微信,WeChat Pay,,EZPWECHAT,,1,,2-3,percentage,跨境支付

package/assets/taiwan-payment/data/providers.csv

@@ -0,0 +1,4 @@
+provider,display_name,auth_method,encryption,test_url,prod_url,test_merchant_id,test_hash_key,test_hash_iv,content_type,features,market_share,api_style
+ecpay,綠界科技 ECPay,SHA256,URL Encode + SHA256,https://payment-stage.ecpay.com.tw/Cashier/AioCheckOut/V5,https://payment.ecpay.com.tw/Cashier/AioCheckOut/V5,3002607,pwFHCqoQZGmho4w6,EkRm7iFT261dpevs,application/x-www-form-urlencoded,完整文檔 | SDK 支援 | 高穩定性 | 多元支付 | 市佔率最高,high,Form POST
+newebpay,藍新金流 NewebPay,AES-256-CBC + SHA256,AES-CBC 雙層加密,https://ccore.newebpay.com/MPG/mpg_gateway,https://core.newebpay.com/MPG/mpg_gateway,請至後台申請,請至後台申請,請至後台申請,application/x-www-form-urlencoded,MPG整合 | 信用卡記憶 | 多元支付 | 雙層加密,high,Form POST + AES
+payuni,統一金流 PAYUNi,AES-256-GCM + SHA256,AES-GCM 加密,https://sandbox-api.payuni.com.tw/api/upp,https://api.payuni.com.tw/api/upp,請至後台申請,請至後台申請,請至後台申請,application/json,統一集團 | AES-GCM加密 | JSON API | RESTful,medium,RESTful JSON

package/assets/taiwan-payment/data/reasoning.csv

@@ -0,0 +1,32 @@
+scenario,recommended_provider,confidence,reason,anti_patterns,use_cases
+高交易量電商,ecpay,HIGH,市佔率最高 | 穩定性佳 | 完整SDK | 社群資源豐富,小型項目會過度設計,大型電商 | 高頻交易 | 需要穩定性
+快速整合,ecpay,HIGH,文檔完整 | 範例豐富 | 測試帳號可用,複雜加密需求,MVP 快速驗證 | 新創項目
+多元支付,newebpay,HIGH,支援 13 種付款方式 | MPG 整合 | 電子錢包,基礎需求過度,需要多種支付方式 | 電商平台
+信用卡記憶,newebpay,HIGH,信用卡記憶功能 | 快速結帳,隱私考量需評估,會員制電商 | 訂閱服務
+簡潔 API,payuni,MEDIUM,JSON RESTful | 統一集團背景 | AES-GCM 加密,大型專案社群資源少,新項目 | API 優先設計
+LINE Pay 整合,newebpay,HIGH,原生支援 LINE Pay | 整合簡單,單一支付方式不需要,LINE 生態系 | 年輕族群
+Apple Pay / Google Pay,newebpay,HIGH,完整支援行動支付 | 多種電子錢包,桌面為主不需要,行動優先 | App 支付
+ATM 轉帳,ecpay,HIGH,虛擬帳號配發 | 自動對帳,即時性要求高,大額交易 | B2B 付款
+超商代碼,ecpay,HIGH,四大超商支援 | 廣泛通路,數位原生族群,無卡族群 | 學生市場
+定期定額,ecpay,HIGH,週期扣款 | 彈性設定,單次交易不需要,訂閱制服務 | SaaS
+BNPL 先買後付,ecpay,MEDIUM,BNPL 無卡分期,風險控管需評估,年輕族群 | 高單價商品
+跨境支付,newebpay,MEDIUM,支援國際卡 | 多元貨幣,國內為主不需要,跨境電商 | 國際客戶
+測試開發,ecpay,HIGH,測試帳號完整 | 測試卡可用,正式環境,開發階段 | 測試驗證
+傳統產業,ecpay,HIGH,市佔率高 | 社群支援好 | 整合商多,技術能力強的團隊,傳統轉型 | 中小企業
+新創公司,payuni,MEDIUM,RESTful 設計 | 統一集團,需要完整文檔參考,新創 API 設計 | 現代架構
+PHP 開發,ecpay,HIGH,PHP SDK 完整 | 範例豐富,非 PHP 技術棧,PHP 電商系統 | WordPress
+Node.js 開發,payuni,MEDIUM,JSON API 友好 | RESTful,無特定框架需求,Node.js 後端 | Express
+Python 開發,ecpay,HIGH,Python 範例完整 | 加密庫支援,無特定框架需求,Django | Flask
+行動 App,newebpay,HIGH,行動支付完整 | Apple/Google Pay,網頁為主,iOS | Android App
+小額付款,ecpay,HIGH,支援超商條碼 | 代碼繳費,大額交易,小額商品 | 虛擬商品
+大額交易,ecpay,HIGH,ATM 轉帳 | 穩定性高 | 安全,小額即時,B2B | 高單價商品
+會員制,newebpay,HIGH,信用卡記憶 | 快速結帳 | 定期扣款,一次性交易,會員訂閱 | 定期服務
+分期付款,ecpay,HIGH,支援 3/6/12/18/24 期 | 銀行合作完整,小額交易,高單價商品 | 3C 電商
+即時到帳,ecpay,HIGH,網路 ATM | 信用卡即時,延遲可接受,需要即時確認訂單
+批次對帳,ecpay,HIGH,API 查詢完整 | CSV 下載,手動對帳,大量訂單處理
+後台管理,ecpay,HIGH,商店後台功能完整 | 報表齊全,API 自動化,需要人工管理
+發票整合,ecpay,HIGH,同時支援金流發票 | 整合簡單,已有發票系統,一站式服務
+物流整合,ecpay,HIGH,同時支援金流物流 | 整合簡單,已有物流系統,一站式服務
+API 文檔,ecpay,HIGH,官方文檔完整 | 中英文,不需文檔參考,學習階段 | 整合開發
+社群支援,ecpay,HIGH,使用者多 | 問題解決快,技術能力強,遇到問題需支援
+成本考量,三家比較,MEDIUM,費率需個別洽談 | 交易量影響,成本非主要考量,費率敏感 | 高毛利商品

package/assets/taiwan-payment/data/troubleshooting.csv

@@ -0,0 +1,18 @@
+issue,symptom,cause,solution,provider,severity
+CheckMacValue 錯誤,回傳 10100058 或 CheckValue Error,參數排序錯誤 | URL Encode 不正確 | 編碼問題,重新檢查 CheckMacValue 計算流程 | 確認 URL Encode 使用 lowercase | 移除 CheckMacValue 本身再計算,ecpay/newebpay,high
+訂單編號重複,回傳 10100003 或訂單已存在,使用相同的 MerchantTradeNo,每筆訂單使用唯一編號 | 建議加入時間戳 | 長度限制 20 字元,ecpay/newebpay/payuni,high
+金額計算錯誤,回傳金額驗算錯誤,金額包含小數 | 金額為負數 | 金額為 0,確保金額為正整數 | 移除小數點 | 最小金額 1 元,ecpay/newebpay/payuni,high
+交易描述包含特殊字元,參數錯誤或亂碼,未進行 URL Encode | 包含特殊符號,使用 urlencode() 編碼 TradeDesc | 避免 & = # 等符號,ecpay/newebpay,medium
+AES 加密失敗,NewebPay TradeInfo 加密錯誤,Key/IV 長度錯誤 | Padding 錯誤 | 編碼問題,確認 HashKey 32 bytes | HashIV 16 bytes | 使用 PKCS7 padding,newebpay,high
+AES-GCM 加密失敗,PayUNi 加密錯誤,Nonce 錯誤 | Tag 未附加 | 編碼問題,確認 IV 作為 nonce | 加密後附加 tag (16 bytes) | 總長度為 encrypted + tag,payuni,high
+收不到付款通知,ReturnURL 未收到通知,URL 不是 HTTPS | 防火牆阻擋 | 回應格式錯誤,確認 ReturnURL 使用 HTTPS | 檢查防火牆 | 回應 "1|OK",ecpay/newebpay/payuni,high
+測試卡無法付款,測試環境刷卡失敗,使用真實卡號 | 測試卡格式錯誤,使用官方提供的測試卡號 | ECPay: 4311-9522-2222-2222 | NewebPay: 4000-2211-1111-1111,ecpay/newebpay,medium
+信用卡交易失敗,顯示交易被拒絕,餘額不足 | 卡片過期 | 銀行風控,請客戶確認卡片狀態 | 聯繫發卡銀行 | 使用其他卡片,ecpay/newebpay/payuni,medium
+ATM 虛擬帳號未產生,ATM 付款未產生帳號,參數設定錯誤 | ExpireDate 格式錯誤,確認 ChoosePayment=ATM | 設定正確的 ExpireDate (yyyy/MM/dd) | 長度 3-60 天,ecpay/newebpay,medium
+超商代碼未產生,CVS 付款未產生代碼,參數設定錯誤 | Desc 長度超過,確認 ChoosePayment=CVS | Desc 限制 20 字元 | 設定 StoreExpireDate,ecpay/newebpay,medium
+定期定額建立失敗,週期扣款設定失敗,參數不完整 | 週期設定錯誤,確認 PeriodAmount/PeriodType/Frequency/ExecTimes 都有填 | PeriodType: D/M/Y,ecpay/newebpay,high
+查詢訂單失敗,QueryTradeInfo 無資料,訂單尚未付款 | MerchantTradeNo 錯誤,確認訂單已付款 | 檢查訂單編號正確性 | 測試環境查測試訂單,ecpay/newebpay/payuni,medium
+請款退款失敗,DoAction 失敗,訂單狀態不符 | 金額錯誤 | 超過期限,確認訂單已授權 | 退款金額不可超過原金額 | 注意請款期限,ecpay/newebpay/payuni,high
+跨域問題,前端導向付款頁失敗,CORS 限制 | 使用 AJAX,使用 Form POST 方式導向 | 不可使用 AJAX | 需整頁跳轉,ecpay/newebpay,medium
+商店代號錯誤,回傳商店不存在,MerchantID 錯誤 | 測試正式環境混用,確認 MerchantID 正確 | 測試環境用測試商店代號 | 正式環境用正式商店代號,ecpay/newebpay/payuni,high
+時間格式錯誤,MerchantTradeDate 格式錯誤,日期格式不符 | 時區問題,使用 yyyy/MM/dd HH:mm:ss 格式 | 使用伺服器時區 | 不可超過當前時間太多,ecpay/newebpay,medium