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,
|
|
2
|
-
merchant_id,商店代號,MerchantID,MerchantID,MerID,string,true
|
|
3
|
-
order_id,訂單編號,MerchantTradeNo,MerchantOrderNo,MerTradeNo,string,true
|
|
4
|
-
order_date,訂單日期,MerchantTradeDate,TimeStamp,TradeTime,string,true,
|
|
5
|
-
amount,交易金額,TotalAmount,Amt,TradeAmt,integer,true
|
|
6
|
-
description,交易描述,TradeDesc,ItemDesc,ProdDesc,string,true
|
|
7
|
-
item_name,商品名稱,ItemName,ItemDesc,ProdDesc,string,true
|
|
8
|
-
return_url,背景通知,ReturnURL,NotifyURL,NotifyURL,string,true,
|
|
9
|
-
client_back_url,前台返回,ClientBackURL,ReturnURL,ReturnURL,
|
|
10
|
-
payment_type,付款方式,ChoosePayment,PaymentType,PayType,string,true
|
|
11
|
-
check_value
|
|
12
|
-
encrypt_type
|
|
13
|
-
trade_no
|
|
14
|
-
rtn_code,回傳代碼,RtnCode,Status,Status,string,false
|
|
15
|
-
rtn_msg,回傳訊息,RtnMsg,Message,Message,string,false
|
|
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,
|
|
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
|
|
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,,,
|
|
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
|
|
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
|
|
32
|
-
pxpay_plus,全支付,PX Pay Plus,DigitalPayment,PXPAY
|
|
33
|
-
plus_pay,全盈+PAY,Plus Pay,DigitalPayment,PLUSPAY
|
|
34
|
-
ipass_money,一卡通 MONEY,iPASS Money,DigitalPayment,IPASSPAY
|
|
35
|
-
easywallet,悠遊付,Easy Wallet,DigitalPayment,EASYCARD
|
|
36
|
-
icash_pay,icash Pay,iCash Pay,DigitalPayment,ICASHPAY,,,,ICASHPAY
|
|
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.
|
|
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",
|