taiwan-payment-skill 1.3.2 → 1.3.4

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.
@@ -1,15 +1,18 @@
1
- field_name,field_zh,ecpay_name,newebpay_name,payuni_name,type,required,max_length,format,notes
2
- merchant_id,商店代號,MerchantID,MerchantID,MerID,string,true,10,,
3
- order_id,訂單編號,MerchantTradeNo,MerchantOrderNo,MerTradeNo,string,true,20,英數字,需唯一
4
- order_date,訂單日期,MerchantTradeDate,TimeStamp,TradeTime,string,true,20,yyyy/MM/dd HH:mm:ss,
5
- amount,交易金額,TotalAmount,Amt,TradeAmt,integer,true,,,無小數
6
- description,交易描述,TradeDesc,ItemDesc,ProdDesc,string,true,200,,需 URL Encode
7
- item_name,商品名稱,ItemName,ItemDesc,ProdDesc,string,true,400,,多項用#分隔
8
- return_url,背景通知,ReturnURL,NotifyURL,NotifyURL,string,true,200,URL,
9
- client_back_url,前台返回,ClientBackURL,ReturnURL,ReturnURL,string,false,200,URL,
10
- payment_type,付款方式,ChoosePayment,PaymentType,PayType,string,true,20,,
11
- check_value,檢查碼,CheckMacValue,CheckValue,CheckSum,string,true,,,SHA256
12
- encrypt_type,加密類型,EncryptType,Version,Version,string,true,,,固定值
13
- trade_no,交易編號,TradeNo,TradeNo,PayUniTradeNo,string,false,20,,平台回傳
14
- rtn_code,回傳代碼,RtnCode,Status,Status,string,false,10,,
15
- rtn_msg,回傳訊息,RtnMsg,Message,Message,string,false,200,,
1
+ field_name,field_zh,ecpay_name,newebpay_name,payuni_name,smilepay_name,pchomepay_name,ezpay_name,paynow_name,shopline_name,linepay_name,tappay_name,type,required,notes
2
+ merchant_id,商店代號,MerchantID,MerchantID,MerID,Dcvc,APP_ID (Basic Auth),MerchantID_,merID,merchantId,channelId,merchant_id,string,true,各家欄位名稱不同;ezPay 後綴底線;PChomePay 用 Basic Auth;TapPay 在 body
3
+ order_id,訂單編號,MerchantTradeNo,MerchantOrderNo,MerTradeNo,Data_id,order_id,MerchantOrderNo,paymentNo,referenceNumber,orderId,order_number,string,true,需唯一;SmilePay/Shopline/LINEPay 限 30+ 字元
4
+ order_date,訂單日期,MerchantTradeDate,TimeStamp,TradeTime,(系統決定),(系統決定),TimeStamp,(系統決定),(系統決定),(系統決定),(系統決定),string,true,ECPay 用 yyyy/MM/dd HH:mm:ss;其他多用 unix timestamp
5
+ amount,交易金額,TotalAmount,Amt,TradeAmt,Amount,amount,Amt,amount,amount.value (cents!),amount,amount,integer,true,Shopline 用分為單位 (NT$1000=100000);其他用元
6
+ description,交易描述,TradeDesc,ItemDesc,ProdDesc,od_sob,(無),ItemDesc,description,description,(no field),details,string,true,需 URL Encode (ECPay)
7
+ item_name,商品名稱,ItemName,ItemDesc,ProdDesc,od_sob,(無),ItemName,(via order),items[],(no field),details,string,true,多項分隔符: ECPay # SmilePay 與 ezPay |
8
+ return_url,背景通知,ReturnURL,NotifyURL,NotifyURL,Roturl,return_url,NotifyURL,webhookUrl,webhookUrl,(no field),notify_url,string,true,HTTPS only;PayNow 現代版用 webhookUrl
9
+ client_back_url,前台返回,ClientBackURL,ReturnURL,ReturnURL,Roturl_status,(無),ReturnURL,resultUrl,returnUrl,confirmUrl,frontend_redirect_url (in result_url),string,false,客戶完成後導回
10
+ payment_type,付款方式,ChoosePayment,PaymentType / channelid,PayType,Pay_zg,pay_type,PaymentType,paymentMethodType,paymentMethods[],(only LINE Pay),(only credit),string,true,各家 enum 不同;ECPay 看 ChoosePayment 表
11
+ check_value,檢查碼/簽章,CheckMacValue,CheckValue,CheckSum,Mid_smilepay (反推加權檢核碼),(no field — 用 token),CheckValue (sha256),X-LINE-Authorization (HMAC),x-slp-signature (HMAC webhook),X-LINE-Authorization (HMAC),(no field; uses Partner Key),string,true,SHA256;TapPay 用 Partner Key in header
12
+ encrypt_type,加密 / Version,EncryptType,Version,Version,Verify_key,(token-based),Version (固定 2.0),(no field),Version,(no field),(no field),string,true,ECPay 固定 1;NewebPay 2.0 / 2.3;ezPay 2.0
13
+ trade_no,平台交易編號,TradeNo,TradeNo,PayUniTradeNo,PaymentNo,(返回 order_id),TradeNo,id (PaymentIntent),id,transactionId,rec_trade_id,string,false,平台回傳的內部編號;列印時需要
14
+ rtn_code,回傳代碼,RtnCode,Status,Status,Status,code,Status,status / type,status,returnCode,status,string,false,各家不同 — 0/1/SUCCESS/Success;TapPay 用 0=success
15
+ rtn_msg,回傳訊息,RtnMsg,Message,Message,Desc,message,Message,message,error / message,returnMessage,msg,string,false,中文訊息;錯誤時帶
16
+ buyer_email,買方信箱,(no field),Email,Email,Email,(via cardholder),Email,(via customer obj),customer.email,(no field),cardholder.email,string,false,
17
+ card_token,記憶卡 token,(via 定期定額),TokenValue,token,(無),(無),TokenValue,(via Customer.cards[]),(via card object),(no field),card_token,string,false,需另申請;用於重複扣款
18
+ card_key,記憶卡 key,(無),(無),(無),(無),(無),(無),(via Customer),(via card object),(no field),card_key,string,false,TapPay 獨有;搭配 card_token 用
@@ -1,6 +1,6 @@
1
1
  method_code,method_zh,method_en,ecpay_code,newebpay_code,payuni_code,smilepay_code,pchomepay_code,ezpay_code,paynow_code,min_amount,max_amount,settlement_days,fee_type,notes
2
2
  credit,信用卡,Credit Card,Credit,CREDIT,credit,Pay_zg=1,CC,CREDIT,CreditCard,1,,2-3,percentage,一次付清
3
- credit_installment,信用卡分期,Credit Installment,Credit+CreditInstallment,INST,installment,Pay_zg=1+Stage,CC_INSTALLMENT,INST,CreditCardInstallment,1000,,依期數,percentage,3/6/12/18/24/30期
3
+ credit_installment,信用卡分期,Credit Installment,Credit+CreditInstallment,InstFlag,installment,Pay_zg=1+Stage,CC_INSTALLMENT,InstFlag,CreditCardInstallment,1000,,依期數,percentage,3/6/12/18/24/30期;NewebPay/ezPay 輸入用 InstFlag(值=1或3,6,12),回傳通知 PaymentType=INST
4
4
  credit_periodic,信用卡定期,Credit Periodic,Credit+Period,,,,,,,,100,,2-3,percentage,週期扣款;PayNow 現代版用 Customer/Card Token
5
5
  credit_red,信用卡紅利,Credit Red,CreditRed,CreditRed,,,,,,,1,,2-3,percentage,紅利折抵
6
6
  unionpay,銀聯卡,UnionPay,UnionPay,UNIONPAY,unionpay,Pay_zg=11,,UNIONPAY,,1,,2-3,percentage,需另申請;SmilePay 用 Pay_zg=11
@@ -13,27 +13,27 @@ applepay,Apple Pay,Apple Pay,ApplePay,APPLEPAY,ApplePay,,,APPLEPAY,ApplePay,1,,2
13
13
  applepay_deferred,Apple Pay 延遲扣款,Apple Pay Deferred,,,,,,,,ApplePayDeferred,,1,,2-3,percentage,PayNow 現代版獨家;先授權後扣款
14
14
  googlepay,Google Pay,Google Pay,,ANDROIDPAY,GooglePay,,,ANDROIDPAY,,1,,2-3,percentage,需申請
15
15
  samsungpay,Samsung Pay,Samsung Pay,,SAMSUNGPAY,SamsungPay,,,SAMSUNGPAY,,1,,2-3,percentage,需申請
16
- linepay,LINE Pay,LINE Pay,,LINEPAY,LinePay,,,LINEPAY,LINEPayOnline,1,,2-3,percentage,PayNow 現代版分線上 (LINEPayOnline) 與線下 (LINEPayOffline)
16
+ linepay,LINE Pay,LINE Pay,DigitalPayment,LINEPAY,LinePay,,,LINEPAY,LINEPayOnline,1,,2-3,percentage,ECPay 走 DigitalPayment umbrella;NewebPay/ezPay 直送 LINEPAY;PAYUNi 直送 LinePay;PayNow 現代版分線上/線下
17
17
  linepay_offline,LINE Pay 線下,LINE Pay Offline,,,,,,,,LINEPayOffline,1,,2-3,percentage,PayNow 現代版獨家
18
18
  esunwallet,玉山 Wallet,E.SUN Wallet,,ESUNWALLET,,,,ESUNWALLET,,1,,2-3,percentage,需申請
19
19
  taiwanpay,台灣 Pay,Taiwan Pay,,TAIWANPAY,,,,TAIWANPAY,,1,49999,2-3,percentage,需申請
20
20
  bitopay,BitoPay,BitoPay,,BITOPAY,,,,BITOPAY,,100,49999,2-3,percentage,加密貨幣
21
21
  twqr,TWQR,TWQR,TWQR,TWQR,TWQR,,,TWQR,,1,,2-3,percentage,台灣Pay QR Code
22
22
  bnpl,無卡分期,BNPL,BNPL,,,,,,,50,300000,依方案,percentage,先買後付
23
- aftee,AFTEE先享後付,AFTEE,,,AFTEE,,,,,1,,2-3,percentage,PayUNi專屬
24
- icash,愛金卡,iCash,,,iCash,,,,iCashPay,1,,2-3,percentage,PayUNi 與 PayNow 兩家支援
23
+ aftee,AFTEE先享後付,AFTEE,,,AFTEE,,,,,1,,2-3,percentage,PayUNi 直送 AFTEE;ECPay 透過 BNPL umbrella
24
+ icash,愛金卡,iCash,,,ICASH,,,,iCashPay,1,,2-3,percentage,PAYUNi 直送 ICASH;PayNow 現代版 iCashPay;ECPay 走 DigitalPayment umbrella
25
25
  ezpalipay,簡單付支付寶,Alipay,,EZPALIPAY,,,,EZPALIPAY,,1,,2-3,percentage,跨境支付
26
26
  ezpwechat,簡單付微信,WeChat Pay,,EZPWECHAT,,,,EZPWECHAT,,1,,2-3,percentage,跨境支付
27
27
  pcpay_wallet,拍錢包,PChome Wallet,,,,,PI,,,,1,,2-3,percentage,PChomePay 獨家;含 5% P 幣回饋
28
- cvs_cod,超商取貨付款,CVS COD,,,,,COD,,,,1,20000,1-3,fixed,PChomePay 獨家;含 7-Eleven 取貨
28
+ cvs_cod,超商取貨付款,CVS COD,,CVSCOM,,,COD,CVSCOM,,,1,20000,1-3,fixed,NewebPay/ezPay 用 CVSCOM (值: 1=取貨不付款 2=取貨付款 3=兩者);PChomePay 用 COD 對應 7-Eleven 取貨
29
29
  weixinpay,微信支付,WeChat Pay (ECPay),WeiXin,EZPWECHAT,,,,EZPWECHAT,,1,,2-3,percentage,ECPay 直接 ChoosePayment=WeiXin;NewebPay/ezPay 走 EZPWECHAT
30
30
  digital_payment,電子支付/電子錢包 umbrella,Digital Payment Umbrella,DigitalPayment,,,,,,,,1,,2-3,percentage,ECPay 專屬 umbrella;客戶於選擇頁挑街口/全盈+PAY/全支付/一卡通/悠遊付/icashpay
31
- jkopay,街口支付,JKO Pay,DigitalPayment,JKOPAY,,,,JKOPAY,,1,,2-3,percentage,ECPay 走 DigitalPayment umbrella;NewebPay/ezPay 直送 JKOPAY
32
- pxpay_plus,全支付,PX Pay Plus,DigitalPayment,PXPAY,,,,PXPAY,,1,,2-3,percentage,全聯系;ECPay umbrella;NewebPay 直送 PXPAY
33
- plus_pay,全盈+PAY,Plus Pay,DigitalPayment,PLUSPAY,,,,PLUSPAY,,1,,2-3,percentage,玉山金控;ECPay umbrella;NewebPay 直送 PLUSPAY
34
- ipass_money,一卡通 MONEY,iPASS Money,DigitalPayment,IPASSPAY,,,,IPASSPAY,,1,,2-3,percentage,一卡通;ECPay umbrella
35
- easywallet,悠遊付,Easy Wallet,DigitalPayment,EASYCARD,,,,EASYCARD,,1,,2-3,percentage,悠遊卡公司;ECPay umbrella
36
- icash_pay,icash Pay,iCash Pay,DigitalPayment,ICASHPAY,,,,ICASHPAY,iCashPay,1,,2-3,percentage,愛金卡;ECPay umbrella;PAYUNi 專屬代碼 iCash
31
+ jkopay,街口支付,JKO Pay,DigitalPayment,JKOPAY?,JKoPay,,,JKOPAY?,,1,,2-3,percentage,同一街口服務跨家命名不同;ECPay 走 DigitalPayment umbrella;PAYUNi JKoPay 已驗證;NewebPay/ezPay JKOPAY 為推測碼(不在 MPG channel-key 表中,需以官方 PDF 確認)
32
+ pxpay_plus,全支付,PX Pay Plus,DigitalPayment,PXPAY?,,,,PXPAY?,,1,,2-3,percentage,全聯系;ECPay umbrella 確認;NewebPay/ezPay PXPAY 為推測碼(不在 MPG channel-key 表中,需以官方 PDF 確認)
33
+ plus_pay,全盈+PAY,Plus Pay,DigitalPayment,PLUSPAY?,,,,PLUSPAY?,,1,,2-3,percentage,玉山金控;ECPay umbrella 確認;NewebPay/ezPay PLUSPAY 為推測碼(需以官方 PDF 確認)
34
+ ipass_money,一卡通 MONEY,iPASS Money,DigitalPayment,IPASSPAY?,,,,IPASSPAY?,,1,,2-3,percentage,一卡通;ECPay umbrella 確認;NewebPay/ezPay IPASSPAY 為推測碼(需以官方 PDF 確認)
35
+ easywallet,悠遊付,Easy Wallet,DigitalPayment,EASYCARD?,,,,EASYCARD?,,1,,2-3,percentage,悠遊卡公司;ECPay umbrella 確認;NewebPay/ezPay EASYCARD 為推測碼(悠遊付為 wallet 產品 vs 悠遊卡實體;可能實際代碼為 EASYWALLET,需以官方 PDF 確認)
36
+ icash_pay,icash Pay,iCash Pay,DigitalPayment,ICASHPAY,,,,ICASHPAY,,1,,2-3,percentage,愛金卡;ECPay umbrella;PAYUNi 直送 ICASH (見 icash 行);PayNow 現代版 PaymentIntent enum 不含 iCashPay;NewebPay/ezPay ICASHPAY 為推測碼(需以官方 PDF 確認)
37
37
  ecpay_pay,綠界Pay,ECPay Pay,EcpayPay,,,,,,,1,,2-3,percentage,ECPay 自家錢包
38
38
  openpoint,OPENPOINT,OPEN POINT,DigitalPayment,,,,,,,1,,2-3,percentage,7-11/統一集團;ECPay umbrella
39
39
  atome,Atome 安多目,Atome,BNPL,,,,,,,1,30000,依方案,percentage,新加坡 BNPL 服務;ECPay 走 BNPL umbrella
@@ -995,3 +995,24 @@ composer require payuni/sdk
995
995
  - **API 文件**: https://www.payuni.com.tw/docs/web/
996
996
  - **GitHub**: https://github.com/payuni
997
997
  - **WooCommerce 外掛**: https://github.com/payuni/PAYUNi_for_WooCommerce
998
+
999
+ ---
1000
+
1001
+ ## PAYUNi 支援的付款方式 (TYPE 對照表)
1002
+
1003
+ 從官方文件 docs.payuni.com.tw 確認支援以下付款方式(其他方式請依後台啟用為準):
1004
+
1005
+ | TYPE / API 路徑提示 | 中文名 | 狀態 |
1006
+ |---|---|---|
1007
+ | `CREDIT` | 信用卡(含一次/分期/紅利/Token 約定/快速結帳) | ✅ 確認 |
1008
+ | `VACC` (虛擬帳號) | ATM 虛擬帳號 | ✅ 確認 |
1009
+ | `CVS` | 超商代碼 | ✅ 確認 |
1010
+ | `ICASH` | 愛金卡 (iCashPay) | ✅ 獨立 API: 交易建立/退款 |
1011
+ | `AFTEE` | AFTEE 先享後付 | ✅ 獨立 API: 建立/確認/退款 |
1012
+ | `LinePay` | LINE Pay | ✅ 獨立 API: 交易建立 |
1013
+ | `JKoPay` | 街口支付(JKO Pay) | ✅ **獨立 API: 交易建立/退款**;同 NewebPay `JKOPAY`,僅命名習慣不同 |
1014
+ | TWQR | TWQR / 台灣 Pay | ✅ 啟用後可用 |
1015
+
1016
+ > **注意**:PAYUNi 的「街口支付」TYPE 為 `JKoPay`(駱駝命名),NewebPay 用 `JKOPAY`(全大寫)。**指向同一個街口服務,只是各家命名習慣不同**——程式中需依該家文件正確大小寫傳值,不能跨家複用字面值。
1017
+
1018
+ 最後更新:2026/05/07
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "taiwan-payment-skill",
3
- "version": "1.3.2",
3
+ "version": "1.3.4",
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.",
5
5
  "keywords": [
6
6
  "taiwan",