taiwan-payment-skill 1.5.5 → 1.5.7

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.
package/README.md CHANGED
@@ -71,7 +71,7 @@ TapPay 用 Prime 一次付清,remember=true 存成 card_token 供下次自動
71
71
  | **O'Pay 歐付寶** | SHA256 CheckMacValue(同 ECPay) | 與 ECPay 同源架構、AccountLink 銀行快付、延遲撥款 |
72
72
  | **JKOPAY 街口** | api-key Header + HMAC-SHA256 digest | 線上支付 / POS / 授權扣款 |
73
73
  | **SunPay 紅陽** | RSA 分段加密 + SHA256 check_value | 金流 + 發票 + 超商代收 |
74
- | **GoMyPay** | 需申請文件 | 參數規格待補 |
74
+ | **GoMyPay** | 需向 GoMyPay 申請規格 | 完整 API 規格未公開 |
75
75
 
76
76
  O'Pay、GoMyPay 以外皆附可執行 Python 範例,加解密以官方測試向量驗證;錯誤碼見 `data/error-codes.csv`。
77
77
 
@@ -71,7 +71,7 @@ TapPay 用 Prime 一次付清,remember=true 存成 card_token 供下次自動
71
71
  | **O'Pay 歐付寶** | SHA256 CheckMacValue(同 ECPay) | 與 ECPay 同源架構、AccountLink 銀行快付、延遲撥款 |
72
72
  | **JKOPAY 街口** | api-key Header + HMAC-SHA256 digest | 線上支付 / POS / 授權扣款 |
73
73
  | **SunPay 紅陽** | RSA 分段加密 + SHA256 check_value | 金流 + 發票 + 超商代收 |
74
- | **GoMyPay** | 需申請文件 | 參數規格待補 |
74
+ | **GoMyPay** | 需向 GoMyPay 申請規格 | 完整 API 規格未公開 |
75
75
 
76
76
  O'Pay、GoMyPay 以外皆附可執行 Python 範例,加解密以官方測試向量驗證;錯誤碼見 `data/error-codes.csv`。
77
77
 
@@ -25,7 +25,7 @@ user-invocable: true
25
25
  - `references/opay-payment-api.md` - 歐付寶 O'Pay 全方位金流(與 ECPay 同源的 CheckMacValue 架構)
26
26
  - `references/jkopay-payment-api.md` - 街口支付 JKOPAY(線上支付 / POS / 授權扣款,三套簽章並存)
27
27
  - `references/sunpay-payment-api.md` - 紅陽 SunPay(RSA 分段加密 + SHA256 check_value)
28
- - `references/gomypay-payment-api.md` - GoMyPay(完整 API 須洽客服,參數待補)
28
+ - `references/gomypay-payment-api.md` - GoMyPay(服務範圍與文件取得;完整 API 規格需向 GoMyPay 申請)
29
29
  - `references/twqr-ewallet-landscape.md` - 電子支付/行動支付生態與 TWQR:全支付、悠遊付等要怎麼收
30
30
  - [EXAMPLES.md](EXAMPLES.md) - 程式碼範例集
31
31
 
@@ -13,30 +13,29 @@ applepay,Apple Pay,Apple Pay,ApplePay,APPLEPAY,ApplePay,,,,,ApplePay,03,1,,2-3,p
13
13
  applepay_deferred,Apple Pay 延遲扣款,Apple Pay Deferred,,,,,,,,ApplePayDeferred,,1,,2-3,percentage,PayNow 現代版獨家;先授權後扣款
14
14
  googlepay,Google Pay,Google Pay,,ANDROIDPAY,GooglePay,,,,,,03,1,,2-3,percentage,需申請
15
15
  samsungpay,Samsung Pay,Samsung Pay,,SAMSUNGPAY,SamsungPay,,,,,,,1,,2-3,percentage,需申請
16
- linepay,LINE Pay,LINE Pay,DigitalPayment,LINEPAY,LinePay,,,,,LINEPayOnline,,1,,2-3,percentage,ECPay 走 DigitalPayment umbrella;NewebPay 直送 LINEPAY;PAYUNi 直送 LinePay;PayNow 現代版分線上/線下
16
+ linepay,LINE Pay,LINE Pay,,LINEPAY,LinePay,,,,,LINEPayOnline,,1,,2-3,percentage,NewebPay 直送 LINEPAY;PAYUNi 直送 LinePay;PayNow 現代版分線上/線下;ECPay DigitalPayment 不含(官方僅 Jkopay、iPASS)
17
17
  linepay_offline,LINE Pay 線下,LINE Pay Offline,,,,,,,,LINEPayOffline,,1,,2-3,percentage,PayNow 現代版獨家
18
18
  esunwallet,玉山 Wallet,E.SUN Wallet,,ESUNWALLET,,,,,TWQR,,,1,,2-3,percentage,需申請
19
19
  taiwanpay,台灣 Pay,Taiwan Pay,,TAIWANPAY,,,,,TWQR,,,1,49999,2-3,percentage,需申請
20
20
  bitopay,BitoPay,BitoPay,,BITOPAY,,,,,,,,100,49999,2-3,percentage,加密貨幣
21
- twqr,TWQR,TWQR,TWQR,TWQR,TWQR,TWQR,,,TWQR,,,1,,2-3,percentage,台灣Pay QR Code;O'Pay ChoosePayment=TWQR 已由官方 PDF 驗證
22
- bnpl,無卡分期,BNPL,BNPL,,,,,,,,,50,300000,依方案,percentage,先買後付
21
+ twqr,TWQR,TWQR,TWQR,TWQR,TWQR,TWQR,,,TWQR,,,1,,2-3,percentage,"台灣Pay QR Code;O'Pay ChoosePayment=TWQR 已由官方 PDF 驗證;ECPay 的 TWQR 為歐付寶 TWQR,需申請開通,6~49,999 元(/36991)"
22
+ bnpl,無卡分期,BNPL,BNPL,,,,,,,,,50,500000,依方案,percentage,"ECPay 無卡分期:裕富 URICH 1,000~500,000、中租 ZINGALA 50~500,000(/36659)"
23
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
24
+ icash,愛金卡,iCash,,,ICASH,,,,,iCashPay,,1,,2-3,percentage,PAYUNi 直送 ICASH;PayNow 現代版 iCashPay;ECPay DigitalPayment 不含(官方僅 Jkopay、iPASS)
25
25
  ezpalipay,簡單付支付寶,Alipay,,EZPALIPAY,,,,,ALIPAY(跨境),,,1,,2-3,percentage,跨境支付
26
26
  ezpwechat,簡單付微信,WeChat Pay,,EZPWECHAT,,,,,WECHAT(跨境),,,1,,2-3,percentage,跨境支付
27
27
  pcpay_wallet,拍錢包,PChome Wallet,,,,,,PI,,,,1,,2-3,percentage,PChomePay 獨家;含 5% P 幣回饋
28
28
  cvs_cod,超商取貨付款,CVS COD,,CVSCOM,,,,COD,,,09 (需 lgs_flag=1),1,20000,1-3,fixed,NewebPay 用 CVSCOM (值: 1=取貨不付款 2=取貨付款 3=兩者);PChomePay 用 COD 對應 7-Eleven 取貨
29
29
  weixinpay,微信支付,WeChat Pay (ECPay),WeiXin,EZPWECHAT,,WeiXinpay,,,WECHAT(跨境),,,1,,2-3,percentage,ECPay 直接 ChoosePayment=WeiXin;NewebPay 走 EZPWECHAT;O'Pay WeiXinpay 已驗證(MerchantTradeNo 限 32 位元、繳費期限 2 小時、無測試回應)
30
- digital_payment,電子支付/電子錢包 umbrella,Digital Payment Umbrella,DigitalPayment,,,,,,,,,1,,2-3,percentage,ECPay 專屬 umbrella;客戶於選擇頁挑街口/全盈+PAY/全支付/一卡通/悠遊付/icashpay
31
- jkopay,街口支付,JKO Pay,DigitalPayment,TWQR,JKoPay,,,,TWQR,,10,1,,2-3,percentage,同一街口服務跨家命名不同;ECPay 走 DigitalPayment umbrella;PAYUNi JKoPay 已驗證;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2)
32
- pxpay_plus,全支付,PX Pay Plus,DigitalPayment,TWQR,,,,,TWQR,,,1,,2-3,percentage,全聯系;ECPay umbrella 確認;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2)
33
- plus_pay,全盈+PAY,Plus Pay,DigitalPayment,TWQR,,,,,TWQR,,,1,,2-3,percentage,玉山金控;ECPay umbrella 確認;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2)
34
- ipass_money,一卡通 MONEY,iPASS Money,DigitalPayment,TWQR,,,,,TWQR,,,1,,2-3,percentage,一卡通;ECPay umbrella 確認;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2)
35
- easywallet,悠遊付,Easy Wallet,DigitalPayment,TWQR,,,,,TWQR,,,1,,2-3,percentage,悠遊卡公司;ECPay umbrella 確認;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2)
36
- icash_pay,icash Pay,iCash Pay,DigitalPayment,TWQR,,,,,TWQR,,,1,,2-3,percentage,愛金卡;ECPay umbrella;PAYUNi 直送 ICASH (見 icash 行);PayNow 現代版 PaymentIntent enum 不含 iCashPay;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2)
37
- ecpay_pay,綠界Pay,ECPay Pay,EcpayPay,,,,,,,,,1,,2-3,percentage,ECPay 自家錢包
38
- openpoint,OPENPOINT,OPEN POINT,DigitalPayment,,,,,,,,,1,,2-3,percentage,7-11/統一集團;ECPay umbrella
30
+ digital_payment,電子支付/電子錢包 umbrella,Digital Payment Umbrella,DigitalPayment,,,,,,,,,1,,2-3,percentage,ECPay 專屬;子項目只有 Jkopay(街口)與 iPASS(一卡通 MONEY),可用 ChooseSubPayment 指定(/5679)
31
+ jkopay,街口支付,JKO Pay,DigitalPayment,TWQR,JKoPay,,,,TWQR,,10,1,,2-3,percentage,同一街口服務跨家命名不同;ECPay 為 DigitalPayment + ChooseSubPayment=Jkopay;PAYUNi JKoPay 已驗證;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2)
32
+ pxpay_plus,全支付,PX Pay Plus,,TWQR,,,,,TWQR,,,1,,2-3,percentage,全聯系;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2);ECPay DigitalPayment 不含(官方僅 Jkopay、iPASS)
33
+ plus_pay,全盈+PAY,Plus Pay,,TWQR,,,,,TWQR,,,1,,2-3,percentage,玉山金控;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2);ECPay DigitalPayment 不含(官方僅 Jkopay、iPASS)
34
+ ipass_money,一卡通 MONEY,iPASS Money,DigitalPayment,TWQR,,,,,TWQR,,,1,,2-3,percentage,一卡通;ECPay 為 DigitalPayment + ChooseSubPayment=iPASS;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2)
35
+ easywallet,悠遊付,Easy Wallet,,TWQR,,,,,TWQR,,,1,,2-3,percentage,悠遊卡公司;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2);ECPay DigitalPayment 不含(官方僅 Jkopay、iPASS)
36
+ icash_pay,icash Pay,iCash Pay,,TWQR,,,,,TWQR,,,1,,2-3,percentage,愛金卡;PAYUNi 直送 ICASH (見 icash 行);PayNow 現代版 PaymentIntent enum 不含 iCashPay;NewebPay 無個別錢包代碼,以 TWQR=1 收款(NDNF-1.2.2);ECPay DigitalPayment 不含(官方僅 Jkopay、iPASS)
37
+ openpoint,OPENPOINT,OPEN POINT,,,,,,,,,,1,,2-3,percentage,7-11/統一集團;ECPay DigitalPayment 不含(官方僅 Jkopay、iPASS)
39
38
  atome,Atome 安多目,Atome,BNPL,,,,,,,,,1,30000,依方案,percentage,新加坡 BNPL 服務;ECPay 走 BNPL umbrella
40
39
  account_link,銀行快付,Account Link,,,,AccountLink,,,,,,1,,2-3,percentage,歐付寶獨有付款方式;ECPay 無對應代碼
41
40
  topup_used,儲值消費,Top Up Used,,,,TopUpUsed,,,,,,1,,2-3,percentage,歐付寶獨有;以歐付寶電支帳戶儲值餘額支付
42
- gamapay,橘子支付,GAMA PAY,DigitalPayment,,,,,,,,,1,,2-3,percentage,橘子支行動支付(第 10 家專營電支機構,先前未收錄);無公開商家文件;TWQR 參與機構;各聚合商代碼待驗證,見 references/twqr-ewallet-landscape.md
41
+ gamapay,橘子支付,GAMA PAY,,,,,,,,,,1,,2-3,percentage,橘子支行動支付(第 10 家專營電支機構,先前未收錄);無公開商家文件;TWQR 參與機構;各聚合商代碼待驗證,見 references/twqr-ewallet-landscape.md;ECPay DigitalPayment 不含(官方僅 Jkopay、iPASS)
@@ -11,5 +11,5 @@ linepay,LINE Pay v4,Channel ID + Channel Secret,HMAC-SHA256 簽章 (X-LINE-Autho
11
11
  tappay,TapPay,Partner Key + App Key + Merchant ID,Prime → pay-by-prime 兩段式,https://sandbox.tappaysdk.com,https://prod.tappayapis.com,請至 TapPay Portal 申請,請至 TapPay Portal 申請,請至 TapPay Portal 申請,application/json,PCI 隔離 | SDK 取得 Prime 後後端付款 | 信用卡/Apple Pay/Google Pay/LINE Pay/街口/全支付/全盈+PAY/悠遊付/一卡通/AFTEE/Virtual Account,medium,RESTful JSON,public,https://docs.tappaysdk.com/,2026-08-08
12
12
  opay,歐付寶 O'Pay,SHA256,URL Encode + SHA256 (同 ECPay CheckMacValue),https://payment-stage.opay.tw/Cashier/AioCheckOut/V5,https://payment.opay.tw/Cashier/AioCheckOut/V5,2000132,5294y06JbISpM5x9,v77hoKGq4kWxNNIS,application/x-www-form-urlencoded,專營電支機構 | 與 ECPay 同源架構 | 獨有 AccountLink 銀行快付/TopUpUsed 儲值消費/WeiXinpay 微信/TWQR | 延遲撥款 HoldTradeAMT | 購物金紅包折抵 | 金流+B2C/B2B/離線發票全公開 PDF,medium,Form POST,public,https://developers.opay.tw/download/document,2026-08-08
13
13
  jkopay,街口支付 JKOPAY,api-key Header + digest 簽章 (POS用Sign OAuth用sign),三套並存: 線上支付HMAC-SHA256簽payload原文 / POS SHA256簽排序JSON尾接MerchantKey須全小寫 / OAuth SHA256簽secret+jsonBody+天數,https://[HOST]/platform (測試付款域 test-onlinepay.jkopay.app),https://[HOST]/platform,請至街口申請,請至街口申請,,application/json,專營電支機構 | 官方公開文件站 | 授權扣款(定期)/線上支付/線下POS/inApp OAuth/街口幣發放 | Entry冪等同單回同網址 | payment_url長度>255 | QRCode僅20分鐘可展延 | 回傳invoice_vehicle可接發票 | 退款180天且用券訂單僅全額退 | 授權扣款限08:00-20:00且同auth_no不可併發 | 折抵金額付款為負退款為正 | 街口幣發放需以同一exchangeId重試否則重複發幣 | 四組網域四套代碼空間 | TWQR 參與機構,large,RESTful JSON,public,https://open-doc.jkos.com/,2026-08-08
14
- sunpay,紅陽科技 SunPay,web + send_time + rsamsg + check_value,RSA分段加密(加密117byte/解密128byte)+Base64 與 SHA256簽章(ASCII排序後尾接SHA2密鑰),https://testtrade.sunpay.com.tw/v4/cash,https://trade.sunpay.com.tw/v4/cash,請至後台申請,RSA公鑰(PEM),SHA2密鑰,application/x-www-form-urlencoded,台灣老牌 | 金流+發票+超商代收+物流(超商便利送/宅配通) | 14家中唯一用RSA不可沿用他家加解密 | send_time格式fffssmmHHyyyyMMdd且120秒逾時 | pay_result值12在交易通知與查詢API意義不同 | 回傳網址不可帶port | CallBack僅補發30分鐘 | 物流限2萬元內 | WooCommerce/Magento2/OpenCart 官方模組 | 官方已出 Claude Code Skill(競品訊號),small,Form POST,public,https://www.sunpay.com.tw/developers/,2026-08-08
15
- gomypay,GoMyPay 台灣萬事達金流,待補,待補,待補,待補,請至後台申請,請至後台申請,,待補,第三方支付 | 信用卡/銀聯/WEBATM/虛擬帳號/超商條碼/定期扣款 | 行動支付手冊完整(台灣PAY/悠遊付/Apple Pay/Google Pay) | 微信線上線下 | 自營發票加值中心,small,Form POST,apply,https://n.gomypay.asia/MDocuments_downloads.aspx,2026-08-08
14
+ sunpay,紅陽科技 SunPay,web + send_time + rsamsg + check_value,RSA分段加密(加密117byte/解密128byte)+Base64 與 SHA256簽章(ASCII排序後尾接SHA2密鑰),https://testtrade.sunpay.com.tw/v4/cash,https://trade.sunpay.com.tw/v4/cash,請至後台申請,RSA公鑰(PEM),SHA2密鑰,application/x-www-form-urlencoded,台灣老牌 | 金流+發票+超商代收+物流(超商取貨付款;官網物流頁另列全家大宗與C2C 7-11/全家/萊爾富) | 14家中唯一用RSA不可沿用他家加解密 | send_time格式fffssmmHHyyyyMMdd且120秒逾時 | pay_result值12在交易通知與查詢API意義不同 | 回傳網址不可帶port | CallBack僅補發30分鐘 | 物流限2萬元內 | WooCommerce/Magento2/OpenCart 官方模組 | 官方已出 Claude Code Skill(競品訊號),small,Form POST,public,https://www.sunpay.com.tw/developers/,2026-08-08
15
+ gomypay,GoMyPay 台灣萬事達金流,需向 GoMyPay 申請,需向 GoMyPay 申請,需向 GoMyPay 申請,需向 GoMyPay 申請,需向 GoMyPay 申請,需向 GoMyPay 申請,,需向 GoMyPay 申請,第三方支付 | 信用卡(含分期)/銀聯/WEBATM/虛擬帳號/超商條碼/超商代碼/定期扣款 | 行動支付(台灣PAY/悠遊付/Apple Pay/Google Pay) | 微信線上線下 | 自營發票加值中心 | 官方購物車模組 WooCommerce/Magento2/OpenCart | 完整API規格未公開,small,Form POST,apply,https://n.gomypay.asia/MDocuments_downloads.aspx,2026-09-24
@@ -30,17 +30,17 @@ Python 開發,ecpay,HIGH,Python 範例完整 | 加密庫支援,無特定框架
30
30
  API 文檔,ecpay,HIGH,官方文檔完整 | 中英文,不需文檔參考,學習階段 | 整合開發
31
31
  社群支援,ecpay,HIGH,使用者多 | 問題解決快,技術能力強,遇到問題需支援
32
32
  成本考量,三家比較,MEDIUM,費率需個別洽談 | 交易量影響,成本非主要考量,費率敏感 | 高毛利商品
33
- 街口訂閱扣款,jkopay,HIGH,街口官方公開文件站 | 授權扣款(定期/訂閱)模組 | 聚合商多半不支援街口定期扣款,只是結帳頁想多一個街口按鈕(走 ECPay DigitalPayment umbrella 更省事),訂閱制 | 街口定期扣款 | 街口幣行銷 | 街口 inApp OAuth
33
+ 街口訂閱扣款,jkopay,HIGH,街口官方公開文件站 | 授權扣款(定期/訂閱)模組 | 聚合商多半不支援街口定期扣款,只是結帳頁想多一個街口按鈕(走 ECPay DigitalPayment + ChooseSubPayment=Jkopay 更省事),訂閱制 | 街口定期扣款 | 街口幣行銷 | 街口 inApp OAuth
34
34
  街口實體店POS,jkopay,MEDIUM,街口線下交易(POS)模組 | 亦可改用 TWQR 一碼收全部電支,純線上電商,實體門市 | POS 收款
35
35
  歐付寶多元支付,opay,HIGH,與 ECPay 同源架構可沿用 CheckMacValue 程式碼 | 獨有 AccountLink 銀行快付/TopUpUsed 儲值消費/WeiXinpay/TWQR | 文件全公開免登入,已深度綁定 ECPay 且無跨境或微信需求,微信支付 | 銀行快付 | 儲值消費 | 從 ECPay 遷移 | 金流+發票同一家
36
36
  延遲撥款/擔保交易,opay,HIGH,HoldTradeAMT=1 延遲撥款 | 款項先留在歐付寶待確認出貨後再申請撥款 | 適合代收代付情境,信用卡付款不適用延遲撥款,平台型電商 | 代收代付 | 擔保交易 | C2C 市集
37
- WooCommerce/Magento/OpenCart 官方模組,sunpay,MEDIUM,三大自架購物車皆有官方模組 | 金流+發票+超商代收+物流(超商便利送/宅配通)一家包辦,需要極高市佔與社群資源者請選 ECPay,自架購物車 | WooCommerce | Magento 2 | OpenCart
38
- 悠遊付/台灣PAY 串接文件,gomypay,MEDIUM,行動支付手冊完整(台灣PAY/悠遊付/Apple Pay/Google Pay) | 悠遊付本身不公開商家文件此為可行路徑,大型電商建議選市佔更高者,悠遊付 | 台灣PAY | 微信線上線下
39
- 電子支付錢包選型,ecpay,HIGH,DigitalPayment umbrella 一次涵蓋街口/全支付/全盈+PAY/一卡通/悠遊付/icash pay | 最省事,需要指定特定錢包做行銷者請改用 PAYUNi 直送代碼或 TapPay,多錢包收款 | 不在意消費者選哪個錢包
40
- 指定特定電子支付錢包,tappay,HIGH,每個錢包有獨立文件與 Prime 流程 | 可精確指定街口/全支付/全盈+PAY/悠遊付/一卡通,只想接一次就好者請用 ECPay umbrella,錢包別行銷 | 分錢包對帳 | 指定錢包
37
+ WooCommerce/Magento/OpenCart 官方模組,sunpay,MEDIUM,三大自架購物車皆有官方模組 | 金流+發票+超商代收+物流(超商取貨付款;官網物流頁另列全家大宗與C2C 7-11/全家/萊爾富)一家包辦,需要極高市佔與社群資源者請選 ECPay,自架購物車 | WooCommerce | Magento 2 | OpenCart
38
+ 金流+發票同一家且行動支付齊全,gomypay,MEDIUM,行動支付涵蓋台灣PAY/悠遊付/Apple Pay/Google Pay | 自營電子發票加值中心 | 有官方購物車模組,需要公開 API 文件自行串接者不適合(規格需申請);大型電商建議選市佔更高者,悠遊付 | 台灣PAY | 微信線上線下
39
+ 電子支付錢包選型,ecpay,HIGH,DigitalPayment 收街口與一卡通 MONEY,其他電子支付走 TWQR(歐付寶 TWQR)| 最省事,需要指定特定錢包做行銷者請改用 PAYUNi 直送代碼或 TapPay,多錢包收款 | 不在意消費者選哪個錢包
40
+ 指定特定電子支付錢包,tappay,HIGH,每個錢包有獨立文件與 Prime 流程 | 可精確指定街口/全支付/全盈+PAY/悠遊付/一卡通,只想接一次就好者請用 ECPay(DigitalPayment 收街口/一卡通,其餘走 TWQR),錢包別行銷 | 分錢包對帳 | 指定錢包
41
41
  電子錢包訂閱制,jkopay,HIGH,街口授權扣款支援定期定額(regular)與不定期不定額(limited)兩種綁定 | 扣款須在08:00-20:00 UTC+8且同一auth_no不可併發 | 週期次數上限week/month/quarter各7次 year 12次,需要跨錢包一次涵蓋者請改用 TWQR 或聚合商 umbrella,電子錢包訂閱 | 街口定期定額 | 按用量計費 | 課金儲值
42
42
  不定期不定額授權,jkopay,HIGH,limited 模式授權後可在額度內隨時扣款 | 適合用量計費與儲值加值 | 額度上限由消費者在App自行設定商家不可控,固定金額訂閱請改用 regular 模式,按用量計費 | 儲值加值 | 變動金額扣款
43
43
  RSA加密金流,sunpay,MEDIUM,紅陽為本 skill 14 家中唯一使用 RSA 分段加密者 | 加密117byte解密128byte | check_value 為 ASCII 排序後尾接 SHA2 密鑰的 SHA256,團隊已熟悉 ECPay CheckMacValue 或 AES 家族且不想再導入 RSA,既有系統已用 RSA | 需要非對稱加密
44
- 金流發票物流一家包辦,sunpay,MEDIUM,金流+電子發票+超商代收+物流(超商便利送/宅配通)同一家 | 支援隨交易自動開立發票 | 宅配通少數可經聚合商取得的路徑,已自行串接發票系統者請勿啟用隨交易開立以免重複開立,一站式整合 | 宅配通需求 | 減少廠商數量
44
+ 金流發票物流一家包辦,sunpay,MEDIUM,金流+電子發票+超商代收+物流(超商取貨付款;官網物流頁另列全家大宗與C2C 7-11/全家/萊爾富)同一家 | 支援隨交易自動開立發票,已自行串接發票系統者請勿啟用隨交易開立以免重複開立,一站式整合 | 減少廠商數量
45
45
  街口幣行銷發放,jkopay,HIGH,街口幣發放 API 可直接發幣給指定用戶做行銷 為聚合商完全無法提供的能力,需自行處理重試冪等 收到 internal error 必須以同一 exchangeId 重送否則重複發幣,街口幣 行銷發放 會員獎勵 積分
46
46
  街口實體店POS完整串接,jkopay,HIGH,POS 模組含付款 取消 退款 查詢四支與 33 個統一錯誤碼,簽章與線上支付不同須另寫;折抵金額正負與線上支付相反,POS 實體店 收銀機 條碼收款
@@ -145,7 +145,7 @@ class SmilePayCreditRedirect:
145
145
  @dataclass
146
146
  class SmilePayNotification:
147
147
  """Roturl 通知解析結果 (取號類 / 信用卡共用)"""
148
- classif: str # A/B/C/T/O
148
+ classif: str # A 信用卡(Foreign=U 為銀聯)/B ATM/C 條碼/E ibon/F FamiPort/T、V 超取付款/O 黑貓取貨付款
149
149
  data_id: str
150
150
  smseid: str
151
151
  amount: int
@@ -517,8 +517,8 @@ class SmilePayPaymentService:
517
517
  )
518
518
 
519
519
  @staticmethod
520
- def build_notification_response(roturl_status: str = 'OK') -> str:
521
- """產生回給 SmilePay 的 Roturlstatus 字串"""
520
+ def build_notification_response(roturl_status: str) -> str:
521
+ """產生回給 SmilePay 的 Roturlstatus 字串;須與建單時送出的 Roturl_status 完全相同,否則會被重送"""
522
522
  return f'<Roturlstatus>{roturl_status}</Roturlstatus>'
523
523
 
524
524
 
@@ -75,6 +75,15 @@ def _canonical(payload: Dict[str, Any]) -> str:
75
75
  return json.dumps(ordered, separators=(',', ':'), ensure_ascii=False)
76
76
 
77
77
 
78
+ def java_urlencode(text: str) -> str:
79
+ """Java URLEncoder 規則(手冊 v1.1.0 附錄 3;官方 JAVA 範例程式同此規則)。
80
+
81
+ 空白編成 `+`、`*` 不編碼、`~` 編成 `%7E`;Python 的 quote 三者都不同。
82
+ rsamsg 的明文與 check_value 必須用同一個編碼後字串(官方 PHP/JAVA 範例皆如此)。
83
+ """
84
+ return urllib.parse.quote_plus(text, safe='*').replace('~', '%7E')
85
+
86
+
78
87
  def make_check_value(payload: Dict[str, Any], sha2_key: str) -> str:
79
88
  """產生 check_value。
80
89
 
@@ -84,7 +93,7 @@ def make_check_value(payload: Dict[str, Any], sha2_key: str) -> str:
84
93
  `HashKey=...&參數&HashIV=...` 的前後包夾。
85
94
  值為 null 的參數不參與簽名(官方明註),本函式已於 build 階段排除。
86
95
  """
87
- encoded = urllib.parse.quote(_canonical(payload), safe='')
96
+ encoded = java_urlencode(_canonical(payload))
88
97
  return hashlib.sha256((encoded + sha2_key).encode('utf-8')).hexdigest()
89
98
 
90
99
 
@@ -94,7 +103,7 @@ def make_rsamsg(payload: Dict[str, Any], public_key_pem: str) -> str:
94
103
  raise RuntimeError('需要 cryptography 套件:pip install cryptography')
95
104
 
96
105
  key = serialization.load_pem_public_key(public_key_pem.encode('utf-8'))
97
- data = urllib.parse.quote(_canonical(payload), safe='').encode('utf-8')
106
+ data = java_urlencode(_canonical(payload)).encode('utf-8')
98
107
 
99
108
  out = bytearray()
100
109
  for i in range(0, len(data), RSA_ENCRYPT_CHUNK):
@@ -288,7 +297,7 @@ def _self_test() -> int:
288
297
  failed = 0
289
298
  print('紅陽官方測試向量驗證')
290
299
 
291
- encoded = urllib.parse.quote(_canonical(payload), safe='')
300
+ encoded = java_urlencode(_canonical(payload))
292
301
  ok = encoded == expected_encoded
293
302
  failed += not ok
294
303
  print(f' [{"PASS" if ok else "FAIL"}] urlencode 結果與手冊逐字相同')
@@ -304,6 +313,12 @@ def _self_test() -> int:
304
313
  print(f' 期望 {expected_check}')
305
314
  print(f' 實得 {got}')
306
315
 
316
+ # 手冊 v1.1.0 附錄 3 的 Java URLEncoder 欄:空白 +、~ %7E、* 不編、/ %2F
317
+ got = java_urlencode('a b~c*d/e')
318
+ ok = got == 'a+b%7Ec*d%2Fe'
319
+ failed += not ok
320
+ print(f' [{"PASS" if ok else "FAIL"}] 特殊字元依 Java URLEncoder 編碼(實得 {got})')
321
+
307
322
  # send_time 格式:毫秒在最前面、日期在最後
308
323
  st = build_send_time(datetime(2023, 9, 27, 16, 21, 34, 585_000))
309
324
  ok = st == '585342116' + '20230927'