taiwan-payment-skill 1.5.7 → 1.5.8

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.
@@ -1126,7 +1126,7 @@ export async function POST(request: Request) {
1126
1126
 
1127
1127
  **錯誤訊息:** ECPay 回傳 `10200073`(CheckMacValue 驗證失敗)
1128
1128
 
1129
- > `10100058` 是「ATM 繳費期限已過」,不是檢查碼錯誤。
1129
+ > `10100058` 是「Pay fail」(3D 驗證未完成,/5740),不是檢查碼錯誤。
1130
1130
 
1131
1131
  **常見的錯誤寫法:**
1132
1132
 
@@ -541,7 +541,7 @@ async function refundPaymentOrder(merchantTradeNo: string, refundAmount: number)
541
541
 
542
542
  **錯誤訊息:** ECPay 回傳 `10200073`(CheckMacValue 驗證失敗),NewebPay 回傳 `MPG02001`(檢查碼錯誤,即 TradeSha 不符)
543
543
 
544
- > 注意:ECPay 的 `10100058` 是「ATM 繳費期限已過」,不是檢查碼錯誤。
544
+ > 注意:ECPay 的 `10100058` 是「Pay fail」(3D 驗證未完成,/5740),不是檢查碼錯誤。
545
545
 
546
546
  **常見原因(ECPay):**
547
547
  1. 排序時區分了大小寫(應不分大小寫,SDK 用 `strcasecmp`)
@@ -1,21 +1,28 @@
1
1
  provider,code,message_zh,message_en,category,severity,solution
2
- ecpay,1,交易成功,Success,success,info,
3
- ecpay,2,ATM 取號成功(等待轉帳),ATM number issued,success,info,不是錯誤;等消費者轉帳後會再收到付款通知
4
- ecpay,10100073,超商代碼 / 條碼取號成功(等待繳費),CVS/Barcode number issued,success,info,不是錯誤;等消費者繳費後會再收到付款通知
5
- ecpay,10100001,超商代碼已失效,CVS code expired,payment,error,重新取號
6
- ecpay,10100058,ATM 繳費期限已過(電子發票服務中為發票作業逾時),ATM payment expired,payment,error,重新建立訂單取號;同一代碼在發票服務含意不同,依收到的服務判斷
7
- ecpay,10100248,帳號錯誤(例如把物流 / 發票帳號用在金流),Wrong merchant account,auth,error,確認金流、物流、發票各自使用正確的 MerchantID / HashKey / HashIV
8
- ecpay,10200009,訂單已過期,Order expired,payment,error,檢查 ExpireDate 設定,重新建立訂單
9
- ecpay,10200043,3D 驗證失敗,3D Secure failed,payment,error,請消費者重新進行 3D 驗證
10
- ecpay,10200047,MerchantTradeNo 重複,Duplicate MerchantTradeNo,validation,error,使用不同的訂單編號(最長 20 字元,僅英數字)
11
- ecpay,10200050,TotalAmount 超出範圍(金額不符),TotalAmount out of range,validation,error,檢查 TotalAmount
12
- ecpay,10200058,信用卡授權失敗,Card authorization failed,payment,error,請消費者確認卡片資訊或更換信用卡
13
- ecpay,10200073,CheckMacValue 驗證失敗,CheckMacValue verify fail,auth,error,不分大小寫排序、PHP urlencode 後轉小寫並還原 ( ) ! *、金流 SHA256 / 物流 MD5;確認 HashKey/HashIV
14
- ecpay,10200095,交易已付款(重複付款),Already paid,payment,warning,檢查訂單是否已處理
15
- ecpay,10200105,BNPL 金額未達最低,BNPL amount below minimum,validation,error,"TotalAmount 需 >= 3,000 元"
16
- ecpay,10200115,信用卡授權逾時,Card authorization timeout,payment,error,請消費者重新付款
17
- ecpay,10300006,超商繳費期限已過(國內物流中為物流訂單已過期),CVS payment expired,payment,error,重新建立訂單;同一代碼在物流服務含意不同
18
- ecpay,10400011,WAF 關鍵字攔截,Blocked by WAF keyword,validation,error,ItemName / TradeDesc 含 echo、python、curl 等系統指令關鍵字,移除即可
2
+ ecpay,1,付款成功,Success,success,info,(/2878)
3
+ ecpay,2,ATM 取號成功,ATM number issued,success,info,不是錯誤;等消費者轉帳後會再收到付款通知(/2881)
4
+ ecpay,10100073,CVS/BARCODE 取號成功,CVS/Barcode number issued,success,info,不是錯誤;等消費者繳費後會再收到付款通知(/2881)
5
+ ecpay,10100001,超商代碼已失效,CVS code expired,payment,error,重新取號(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)
6
+ ecpay,10100058,Pay fail(3D 驗證未完成),Pay fail.,payment,error,請消費者更換瀏覽器或裝置、關閉 VPN、切換網路取得新 IP;定期定額時手機號碼須與銀行資料一致(/5740)
7
+ ecpay,10100248,信用卡被銀行拒絕,Wrong merchant account,payment,error,資料錯誤、額度不足等,請消費者洽發卡行(/5740)
8
+ ecpay,10200009,訂單已過期,Order expired,payment,error,檢查 ExpireDate 設定,重新建立訂單(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)
9
+ ecpay,10200043,3D 驗證失敗,3D Secure failed,payment,error,請消費者重新進行 3D 驗證(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)
10
+ ecpay,10200047,MerchantTradeNo 重複,Duplicate MerchantTradeNo,validation,error,使用不同的訂單編號(最長 20 字元,僅英數字)(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)
11
+ ecpay,10200050,TotalAmount 超出範圍(金額不符),TotalAmount out of range,validation,error,檢查 TotalAmount(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)
12
+ ecpay,10200058,信用卡授權失敗,Card authorization failed,payment,error,請消費者確認卡片資訊或更換信用卡(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)
13
+ ecpay,10200073,CheckMacValue 驗證失敗,CheckMacValue verify fail,auth,error,不分大小寫排序、PHP urlencode 後轉小寫並還原 ( ) ! *、金流 SHA256 / 物流 MD5;確認 HashKey/HashIV(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)
14
+ ecpay,10200095,訂單未成立,消費者未完成付款,Already paid,payment,warning,查詢 API 的 TradeStatus;不是已付款或已退款(/2890)
15
+ ecpay,10200105,BNPL 金額未達最低,BNPL amount below minimum,validation,error,"TotalAmount 需 >= 3,000 元(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)"
16
+ ecpay,10200115,信用卡授權逾時,Card authorization timeout,payment,error,請消費者重新付款(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)
17
+ ecpay,10300006,超商繳費期限已過(國內物流中為物流訂單已過期),CVS payment expired,payment,error,重新建立訂單;同一代碼在物流服務含意不同(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)
18
+ ecpay,10400011,WAF 關鍵字攔截,Blocked by WAF keyword,validation,error,ItemName / TradeDesc 含 echo、python、curl 等系統指令關鍵字,移除即可(出處:綠界官方 skill guides/20,developers.ecpay.com.tw 未列,以後台「交易狀態代碼查詢」為準)
19
+ ecpay,10800001,觸發綠界風控,,payment,error,連續刷卡、可疑電話等;後台交易明細灰底表示扣款失敗(/5740)
20
+ ecpay,10200141,商店未開啟收款服務,,config,error,測試/正式環境金鑰混用,或正式環境未完成金流申請(/5740)
21
+ ecpay,10200146,此商店不支援信用卡分期,,config,error,分期服務未啟用(/5740)
22
+ ecpay,10300023,本次交易未提供任何付款方式,,config,error,MerchantID 錯誤,或收款審核未通過、服務未開通(/5740)
23
+ ecpay,10300024,資料驗證錯誤,請回到原廠商頁面重新操作,,payment,warning,消費者於簡訊驗證時返回上一頁再送出所致(/5740)
24
+ ecpay,5100070,建立訂單失敗:金額超出上下限或無可用付款方式,,api,error,例:1 元訂單只開 ATM;測試環境請用 2 元以上(/5740)
25
+ ecpay,5100071,建立訂單失敗:無權限使用,,config,error,服務未開通,請聯繫業務(/5740)
19
26
  newebpay,SUCCESS,成功,Success,success,info,
20
27
  newebpay,MPG01002,時間戳記不可空白,,validation,error,見藍新規格書 NDNF-1.2.2 錯誤代碼表
21
28
  newebpay,MPG01005,TokenTerm 不可空白/設定錯誤,,validation,error,見藍新規格書 NDNF-1.2.2 錯誤代碼表
@@ -535,7 +535,7 @@ async function refundPaymentOrder(merchantTradeNo: string, refundAmount: number)
535
535
 
536
536
  **錯誤訊息:** ECPay 回傳 `10200073`(CheckMacValue 驗證失敗),NewebPay 回傳 `MPG02001`(檢查碼錯誤,即 TradeSha 不符)
537
537
 
538
- > 注意:ECPay 的 `10100058` 是「ATM 繳費期限已過」,不是檢查碼錯誤。
538
+ > 注意:ECPay 的 `10100058` 是「Pay fail」(3D 驗證未完成,/5740),不是檢查碼錯誤。
539
539
 
540
540
  **常見原因(ECPay):**
541
541
  1. 排序時區分了大小寫(應不分大小寫,SDK 用 `strcasecmp`)
package/dist/index.js CHANGED
@@ -16358,7 +16358,7 @@ function listCommand() {
16358
16358
  var import_chalk5 = __toESM(require_source());
16359
16359
 
16360
16360
  // src/version.ts
16361
- var VERSION = "1.5.7";
16361
+ var VERSION = "1.5.8";
16362
16362
 
16363
16363
  // src/commands/info.ts
16364
16364
  async function infoCommand() {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "taiwan-payment-skill",
3
- "version": "1.5.7",
3
+ "version": "1.5.8",
4
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",