taiwan-payment-skill 1.5.12 → 1.5.13

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.
@@ -117,7 +117,7 @@ When modifying files:
117
117
  | Claude Code | `.claude` | full |
118
118
  | Cursor | `.cursor` | full |
119
119
  | Windsurf | `.windsurf` | full |
120
- | Antigravity | `.agent` | full |
120
+ | Antigravity | `.agents` | full |
121
121
  | Copilot | `.github` | full |
122
122
  | Kiro | `.kiro` | full |
123
123
  | Codex | `.agents` | full |
@@ -1352,7 +1352,7 @@ https://payment-stage.opay.tw/Cashier/AioCheckOut/V5
1352
1352
  2. **連空白都算數**。官方範例 `"currency": "TWD"` 冒號後有空格,拿掉 digest 就變。**先組好字串、簽它、原封不動送出**,不要簽完再用另一次 `json.dumps()` 產生 body。
1353
1353
  3. **街口有三套簽章**(線上支付/POS/OAuth),程式碼不可共用。見 [reference §7](references/jkopay-payment-api.md)。
1354
1354
  4. **對帳用 `debit_amount` 不是 `final_price`**。街口幣與券折抵不進撥款,用 `final_price` 對帳會長期短差。
1355
- 5. **授權扣款有六個硬限制**,其中兩個直接約束排程設計:`306` 扣款只能在 **08:00–20:00** 發動(夜間 batch 必失敗)、`307` 同一 `auth_no` **不可併發**(扣款必須序列化)。
1355
+ 5. **授權扣款有五個硬限制**,其中 `307` 直接約束排程設計:同一 `auth_no` **不可併發**(扣款必須序列化)。
1356
1356
 
1357
1357
  ### 一個資料庫層的地雷
1358
1358
 
@@ -780,7 +780,6 @@ jkopay,302,授權編號已取消,Canceled auth_no,business,error,該授權已終
780
780
  jkopay,303,超過用戶設定的最高額度,FinalPrice exceeded the max amount quota set by the user,business,error,額度由消費者在街口 App 自行設定 非商家可控 須請消費者調高
781
781
  jkopay,304,金額與授權帳單金額不一致,Order finalPrice is not consistent with authpay billing amount,validation,error,定期定額的 final_price 必須等於綁定時的 billing_amount
782
782
  jkopay,305,超過當前週期扣款次數,Authpay payment exceeds current billing cycle times,business,error,週期次數上限 week/month/quarter<=7 year<=12 檢查 billing_cycle.times
783
- jkopay,306,授權扣款時段無效,Authpay payment transaction time invalid.(Available at 08:00 - 20:00 UTC+8),business,error,授權扣款僅限 08:00-20:00 UTC+8 排程勿排夜間
784
783
  jkopay,307,同一授權不可併發扣款,Payment with the same auth_no is allowed one at a time,business,error,同一 auth_no 同時僅允許一筆付款 扣款須序列化
785
784
  sunpay,10,交易成功,Transaction Success,success,info,交易通知 status / 查詢 result.status(紅陽金流技術串接手冊 v1.1.0 4.3、4.4.2)
786
785
  sunpay,11,交易失敗,Transaction Failed,payment,error,交易通知 status / 查詢 result.status;查 msg 確認原因(紅陽金流技術串接手冊 v1.1.0 4.3、4.4.2)
@@ -5,7 +5,7 @@ credit_action,信用卡請退款,/CreditDetail/DoAction,/API/CreditCard/Close,/a
5
5
  query_credit,信用卡查詢,/CreditDetail/QueryTrade/V2,/API/QueryTradeInfo,/api/trade/query,N/A,/v1/refund/{refund_id},N/A,N/A,/api/v1/refund/{id},/CreditDetail/QueryTrade/V2,N/A,N/A,POST,"MerchantID,CreditRefundId",查詢信用卡交易
6
6
  periodic_create,定期定額建立,/Cashier/AioCheckOut/V5,/MPG/period,,N/A,N/A,,N/A,/api/v1/customer (saved card),/Cashier/AioCheckOut/V5,/platform/authpay/regular 或 /limited,N/A,POST,"PeriodAmount,PeriodType,Frequency,ExecTimes",設定週期付款;PayNow 現代版用 Customer + Card Token 機制 | 街口 JKOPAY 授權扣款分定期定額 regular 與不定期不定額 limited 兩種;歐付寶 O'Pay 同綠界定期定額
7
7
  periodic_query,定期定額查詢,/Cashier/QueryCreditCardPeriodInfo,/MPG/period/query,,N/A,N/A,,N/A,N/A,/Cashier/QueryCreditCardPeriodInfo,/platform/authpay/detail,N/A,POST,"MerchantID,MerchantTradeNo",查詢週期付款
8
- periodic_action,定期定額操作,/Cashier/CreditCardPeriodAction,/MPG/period/AlterStatus(暫停/終止/啟用)、/MPG/period/AlterAmt(金額/週期/期數/到期日),,N/A,N/A,,N/A,N/A,,/platform/authpay/transaction (扣款) 與 /cancel (終止),N/A,POST,"MerchantID,Action",取消/修改週期 | 街口 JKOPAY 扣款限 08:00-20:00 UTC+8 且同一 auth_no 不可併發
8
+ periodic_action,定期定額操作,/Cashier/CreditCardPeriodAction,/MPG/period/AlterStatus(暫停/終止/啟用)、/MPG/period/AlterAmt(金額/週期/期數/到期日),,N/A,N/A,,N/A,N/A,,/platform/authpay/transaction (扣款) 與 /cancel (終止),N/A,POST,"MerchantID,Action",取消/修改週期 | 街口 JKOPAY 同一 auth_no 扣款不可併發
9
9
  get_token,取得 Token,N/A,N/A,N/A,N/A,/v1/token,N/A,N/A,N/A,N/A,N/A,N/A,POST,"BasicAuth(APP_ID,SECRET)",PChomePay 兩階段認證;token 預設 28800 秒 (8h) 有效
10
10
  balance_query,查詢餘額,N/A,N/A,N/A,N/A,/v1/balance,N/A,N/A,N/A,N/A,N/A,N/A,GET,pcpay-token header,PChomePay 商家後台帳戶餘額
11
11
  withdraw,提領款項,N/A,N/A,N/A,N/A,/v1/withdraw,N/A,N/A,N/A,N/A,N/A,N/A,POST,"amount,bank,account",PChomePay 提領至銀行
@@ -10,6 +10,6 @@ shopline,Shopline Payments,merchantId + apiKey HTTP Header,Header 認證 + HMAC-
10
10
  linepay,LINE Pay v4,Channel ID + Channel Secret,HMAC-SHA256 簽章 (X-LINE-Authorization-Nonce + Signature),https://sandbox-api-pay.line.me,https://api-pay.line.me,請至 LINE Pay Merchant Center 申請,請至 LINE Pay Merchant Center 申請,,application/json,LINE 生態 | 全球用戶 | 自動扣款 (Preapproved Pay) | 信用卡/帳戶餘額/POINT | 連加電支,large,RESTful JSON,public,https://developers-pay.line.me/zh/online-api-v4,2026-08-08
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
- 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
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天且用券訂單僅全額退 | 授權扣款同auth_no不可併發 | 折抵金額付款為負退款為正 | 街口幣發放需以同一exchangeId重試否則重複發幣 | 四組網域四套代碼空間 | TWQR 參與機構,large,RESTful JSON,public,https://open-doc.jkos.com/,2026-08-08
14
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,自行註冊 testmerchant.sunpay.com.tw(立即申請),RSA公鑰(PEM),SHA2密鑰,application/x-www-form-urlencoded,"台灣老牌 | 金流+發票+超商代收+物流(超商取貨付款,不支援OK;官方確認目前無物流API) | 14家中唯一用RSA不可沿用他家加解密 | send_time格式fffssmmHHyyyyMMdd且120秒逾時 | pay_result值12在交易通知與查詢API意義不同 | 回傳網址不可帶port | CallBack僅補發30分鐘 | 物流限2萬元內 | WooCommerce/Magento2/OpenCart 官方模組 | 官方已出 Claude Code Skill(競品訊號) | check_value 手冊v1.1.1起可不做URLEncode(做了也相容)",small,Form POST,public,https://www.sunpay.com.tw/developers/,2026-09-29
15
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
@@ -38,7 +38,7 @@ WooCommerce/Magento/OpenCart 官方模組,sunpay,MEDIUM,三大自架購物車皆
38
38
  金流+發票同一家且行動支付齊全,gomypay,MEDIUM,行動支付涵蓋台灣PAY/悠遊付/Apple Pay/Google Pay | 自營電子發票加值中心 | 有官方購物車模組,需要公開 API 文件自行串接者不適合(規格需申請);大型電商建議選市佔更高者,悠遊付 | 台灣PAY | 微信線上線下
39
39
  電子支付錢包選型,ecpay,HIGH,DigitalPayment 收街口與一卡通 MONEY,其他電子支付走 TWQR(歐付寶 TWQR)| 最省事,需要指定特定錢包做行銷者請改用 PAYUNi 直送代碼或 TapPay,多錢包收款 | 不在意消費者選哪個錢包
40
40
  指定特定電子支付錢包,tappay,HIGH,每個錢包有獨立文件與 Prime 流程 | 可精確指定街口/全支付/全盈+PAY/悠遊付/一卡通,只想接一次就好者請用 ECPay(DigitalPayment 收街口/一卡通,其餘走 TWQR),錢包別行銷 | 分錢包對帳 | 指定錢包
41
- 電子錢包訂閱制,jkopay,HIGH,街口授權扣款支援定期定額(regular)與不定期不定額(limited)兩種綁定 | 扣款須在08:00-20:00 UTC+8且同一auth_no不可併發 | 週期次數上限week/month/quarter各7次 year 12次,需要跨錢包一次涵蓋者請改用 TWQR 或聚合商 umbrella,電子錢包訂閱 | 街口定期定額 | 按用量計費 | 課金儲值
41
+ 電子錢包訂閱制,jkopay,HIGH,街口授權扣款支援定期定額(regular)與不定期不定額(limited)兩種綁定 | 同一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
44
  金流發票物流一家包辦,sunpay,MEDIUM,金流+電子發票+超商代收+物流(超商取貨付款;官網物流頁另列全家大宗與C2C 7-11/全家/萊爾富)同一家 | 支援隨交易自動開立發票,已自行串接發票系統者請勿啟用隨交易開立以免重複開立,一站式整合 | 減少廠商數量
@@ -27,7 +27,6 @@ RESTful 端點錯誤,404 Not Found | 405 Method Not Allowed,端點路徑錯誤 |
27
27
  紅陽 CallBack 收不到,交易完成但系統未更新狀態,回傳網址含連接埠會被資安風控阻擋 | CallBack 僅在 30 分鐘內每 5 分鐘補發 超過即不再補發,移除網址中的 port;另實作查詢 API 定時對帳補回漏收的交易,sunpay,high
28
28
  紅陽超商代碼商品金額不符,交易被拒不允許送出,product 陣列的單價乘數量總和與 mn 不一致,調整商品明細使總和等於 mn;商品過多或含負數金額時整合為單一商品名稱送出,sunpay,medium
29
29
  紅陽物流通知解析失敗,貨態通知內容為亂碼或無法解析 JSON,物流狀態通知是 HTTP FORM POST key-value 非 JSON 且全部欄位經過 URL Encode,先 URL Decode(UTF-8) 再處理;注意訂單編號欄位為大寫 Td 與請求端的 td 不同,sunpay,medium
30
- 街口授權扣款夜間失敗,回 306 Authpay payment transaction time invalid,授權扣款僅限 08:00-20:00 UTC+8 發動,將扣款排程改到白天時段;失敗需保留重試佇列待隔日,jkopay,high
31
30
  街口授權扣款併發失敗,回 307 Payment with the same auth_no is allowed one at a time,同一 auth_no 同時僅允許一筆付款,以授權編號為鍵序列化扣款請求 勿並行送出,jkopay,high
32
31
  街口三套簽章搞混,不同模組驗簽一直失敗,街口線上支付用 HMAC-SHA256 簽 payload 原文;線下 POS 用 SHA256 簽排序後 JSON 尾接 MerchantKey 且須全小寫;OAuth 用 SHA256 簽 secret+jsonBody+timestamp除以1000除以86400 且需先轉小寫再轉大寫,三個模組的簽章程式碼必須各寫一份 不可共用,jkopay,high
33
32
  街口 POS 驗簽失敗 904,POS 付款回 StatusCode 904,欄位未依 Key 字母排序 | JSON 含空白或換行 | 字串欄位省略未帶空字串 | Sign 未轉全小寫,序列化時排序去空白 空值欄位帶空字串 最後將 Sign 轉小寫,jkopay,high
@@ -220,8 +220,7 @@ class JkopayClient:
220
220
  ) -> Dict[str, Any]:
221
221
  """以既有授權發動扣款。
222
222
 
223
- 六個硬限制,設計排程前務必知道(回應碼見 reference §6.6):
224
- 306 扣款只能在 08:00–20:00 (UTC+8) 發動 —— 夜間 batch 必失敗
223
+ 五個硬限制,設計排程前務必知道(回應碼見 reference §6.6):
225
224
  307 同一 auth_no 同時只允許一筆付款 —— 扣款必須序列化
226
225
  303 金額超過「消費者自己在 App 設定的額度」,商家不可控
227
226
  304 final_price 必須等於授權時的 billing_amount
@@ -30,7 +30,7 @@ GoMyPay(台灣萬事達金流股份有限公司)是台灣合規的第三方
30
30
 
31
31
  | 類別 | 項目 |
32
32
  |---|---|
33
- | 購物車模組 | WooCommerce V2 (v1.6.4)、WooCommerce V1 (v1.1.0)、Magento2、OpenCart |
33
+ | 購物車模組 | WooCommerce V2 (v1.7.0,2026-10-16)、WooCommerce V1 (v1.1.0)、Magento2、OpenCart |
34
34
  | 行動支付手冊 | 台灣PAY、悠遊付、Apple Pay、Google Pay |
35
35
  | 微信支付 API | 線上版、線下版 |
36
36
  | 其他 | 物流商家資料表、超商代碼繳費流程 |
@@ -463,20 +463,19 @@ Response 的 `result_object` 與 OnlinePay 的 `result_url` 同構(`tradeNo`
463
463
 
464
464
  > `status` 非 0 時,其餘欄位一律不回傳——別預期拿得到 `tradeNo`。
465
465
 
466
- ### 6.6 ⚠️ 授權扣款的六個硬限制
466
+ ### 6.6 ⚠️ 授權扣款的五個硬限制
467
467
 
468
468
  這些是設計訂閱系統時**必須先知道**的,全部來自 `/authpay/transaction` 的回應碼:
469
469
 
470
470
  | result | 限制 |
471
471
  |---|---|
472
- | `306` | **扣款只能在 08:00–20:00(UTC+8)發動**。半夜跑 batch 一定失敗——排程要避開 |
473
472
  | `307` | **同一 `auth_no` 同時只允許一筆付款**,不能併發 |
474
473
  | `303` | 金額超過**用戶自己在 App 設定的最高額度**(不是你設的)|
475
474
  | `304` | 訂單 `final_price` 與授權時的 `billing_amount` 不一致 |
476
475
  | `305` | 超過當前計費週期的扣款次數(見 6.3 上限表)|
477
476
  | `104` | 超過**月限額**(電支法規的個人限額)|
478
477
 
479
- > 前兩項是排程設計的直接約束:**扣款 job 要排在白天,而且同一授權要序列化**。
478
+ > 第一項是排程設計的直接約束:**同一授權的扣款要序列化**。
480
479
 
481
480
  ### 6.7 端點總表與回應碼
482
481
 
@@ -500,7 +499,6 @@ Response 的 `result_object` 與 OnlinePay 的 `result_url` 同構(`tradeNo`
500
499
  | `303` | FinalPrice exceeded the max amount quota set by the user | 超過用戶設定額度 |
501
500
  | `304` | Order finalPrice is not consistent with authpay billing amount | 金額與授權不符 |
502
501
  | `305` | Authpay payment exceeds current billing cycle times | 超過週期次數 |
503
- | `306` | Authpay payment transaction time invalid.(Available at 08:00 - 20:00 UTC+8) | **時段限制** |
504
502
  | `307` | Payment with the same auth_no is allowed one at a time | 同授權不可併發 |
505
503
  | `110` | Store not found | 查無商店 |
506
504
  | `115` | Payment failed | 付款失敗 |
@@ -688,7 +686,7 @@ OAuth 專屬錯誤碼:`OA-001` 成功、`OA-205` Auth Code 已被使用、`OA-
688
686
 
689
687
  - npm 套件在街口自有 registry:`https://npmjs.jkos.com/-/web/detail/@jkos/openweb-bridge`
690
688
  - ⚠️ **v2.0.6 與先前版本不相容**:使用 v2.0.4(含)以下者,升級前須先聯絡街口窗口
691
- - 文件另有 v2.0.8 與 Next 兩組 API 頁面,版本表未列。街口的 UMD 套件中心 `https://upkg.jkos.com/`(2026-09-24 查核)列出 `openweb-bridge` v2.0.0–v2.0.8,**v2.0.8 為最新**:`https://upkg.jkos.com/openweb-bridge/v2.0.8/jkos.umd.js`;沒有獨立的 Next 版檔案
689
+ - 文件站以 v2.0.8 為目前版本(另保留 v2.0.2–v2.0.7 各版 API 頁面),但版本表未列 2.0.8。街口的 UMD 套件中心 `https://upkg.jkos.com/`(2026-09-24 查核)列出 `openweb-bridge` v2.0.0–v2.0.8,**v2.0.8 為最新**:`https://upkg.jkos.com/openweb-bridge/v2.0.8/jkos.umd.js`;沒有獨立的 Next 版檔案
692
690
  - 官方未標示建議版本,採用前向街口窗口確認
693
691
 
694
692
  **Next 版 API**:`getAuthCode`(喚起原生授權頁取得 auth code,接 §9 OAuth)、`setNavTitle`、`setNavBackground`、`setNavLeftButton`、`setNavRightButton`、`clearNavRightButton`、`openBrowser`、`redirectMaintainPage`、`close`、`showModal`、`setPullRefreshOn`/`setPullRefreshOff`。
@@ -821,21 +819,21 @@ OAuth 專屬錯誤碼:`OA-001` 成功、`OA-205` Auth Code 已被使用、`OA-
821
819
  ## 13. 來源
822
820
 
823
821
  - 街口開放文件 — https://open-doc.jkos.com/
824
- - 線上支付 OnlinePay — https://open-doc.jkos.com/?docs=線上支付onlinepay
825
- - API 協議規則 — `…/線上支付onlinepay/串接說明/api-協議規則`
826
- - 加簽加密說明 — `…/線上支付onlinepay/串接說明/加簽加密說明`
827
- - 訂單創建 Entry API — `…/線上支付onlinepay/api列表/訂單創建-api`
828
- - 代碼意義 API Response Code — `…/線上支付onlinepay/api列表/代碼意義`
829
- - 店家撥款檔 R 檔(線上支付)— `…/線上支付onlinepay/api列表/店家撥款檔r檔`
830
- - 店家撥款檔 R 檔(線下 POS)— `…/線下交易pos/api列表/店家撥款檔r檔`
831
- - Web SDK 版本 — https://open-doc.jkos.com/?docs=inapp-第三方服務/web-sdk/sdk-環境版本
822
+ - 線上支付 OnlinePay — https://open-doc.jkos.com/online-pay/
823
+ - API 協議規則 — https://open-doc.jkos.com/online-pay/general/api-protocol-rules
824
+ - 加簽加密說明 — https://open-doc.jkos.com/online-pay/general/signature
825
+ - 訂單創建 Entry API — https://open-doc.jkos.com/online-pay/api/entry
826
+ - 代碼意義 API Response Code — https://open-doc.jkos.com/online-pay/api/response-code
827
+ - 店家撥款檔 R 檔(線上支付)— https://open-doc.jkos.com/online-pay/api/reimburse-file
828
+ - 店家撥款檔 R 檔(線下 POS)— https://open-doc.jkos.com/pos/api/reimburse-file
829
+ - Web SDK(v2.0.8,含版本表、基礎開放能力、介面交互、按鈕、錯誤代碼)— https://open-doc.jkos.com/web-sdk/
832
830
  - UMD 套件中心 — https://upkg.jkos.com/
833
- - Web SDK Next — `…/inapp-第三方服務/web-sdk/next`(基礎開放能力、介面交互、按鈕、錯誤代碼)
834
- - 授權扣款 Authorized Payment — https://open-doc.jkos.com/?docs=授權扣款-authorized-payment
835
- - 授權創建 Binding — `…/授權扣款-authorized-payment/api列表-api-lists/授權綁定創建-authorization-binding`
836
- - 授權綁定結果通知 CallBack — `…/api列表-api-lists/授權綁定結果通知-authorization-callback`
837
- - 授權扣款發動 — `…/api列表-api-lists/授權扣款發動-merchant-platform-authorization-request`
838
- - 授權模組代碼意義 — `…/授權扣款-authorized-payment/api列表-api-lists/代碼意義-api-response-code`
831
+ - 授權扣款 Authorized Payment — https://open-doc.jkos.com/authorized-payment/
832
+ - 授權創建 Binding — https://open-doc.jkos.com/authorized-payment/api/create-authorization
833
+ - 授權綁定結果通知 CallBack — https://open-doc.jkos.com/authorized-payment/api/authorization-callback
834
+ - 授權扣款發動 — https://open-doc.jkos.com/authorized-payment/api/deduction
835
+ - 授權模組代碼意義 — https://open-doc.jkos.com/authorized-payment/api/response-code
836
+ - 文件站為需 JavaScript 渲染的 Docusaurus 網站(2026-10 改版,舊 `?docs=` 網址一律導回首頁)
839
837
  - 街口店家收款 — https://www.jkopay.com/application/store
840
838
  - TapPay 街口 Backend 文件 — https://docs.tappaysdk.com/jko-pay/zh/back.html
841
839
  - TapPay 街口支付服務頁 — https://www.tappaysdk.com/taiwan-zhtw/service/payments/jko-pay
@@ -48,7 +48,7 @@
48
48
  | 整合式支付頁 | `/upp` | 導向 PayUni 支付頁面 |
49
49
  | ATM 虛擬帳號 | `/atm` | 幕後取得虛擬帳號 |
50
50
  | 超商代碼 | `/cvs` | 幕後取得繳費代碼 |
51
- | 信用卡幕後 | `/credit` | 信用卡直接扣款 |
51
+ | 信用卡幕後 Token 交易 | `/credit` | 以既有 `CreditHash` 授權(不收卡號;舊版帶卡號幕後已於 2026-07-01 移除) |
52
52
  | LINE Pay | `/linepay` | LINE Pay 支付 |
53
53
  | AFTEE 先享後付 | `/aftee_direct` | AFTEE 支付 |
54
54
 
@@ -370,12 +370,16 @@ echo $html;
370
370
 
371
371
  ## 信用卡幕後
372
372
 
373
- 直接在商店頁面完成信用卡扣款,不需導向 PayUni。
373
+ > **官方已於 2026-07-01 移除舊版「信用卡幕後(CREDIT)」**(直接帶卡號的幕後授權),改為「信用卡幕後 Token 交易(CREDIT)」
374
+ > (官方文件 page 522、修改記錄 page 25)。現行 `/api/credit` **不收卡號**,只能以既有信用卡 Token 授權。
375
+
376
+ 流程:先以整合式支付頁(UPP)或信用卡免跳轉支付元件(UNi Embed)完成首次交易並同意建立 Token,取得 `CreditHash`;
377
+ 之後以 `CreditHash` 呼叫本 API 進行與持卡人約定的授權。須向 PAYUNi 申請信用卡 Token 機制並綁定幕後授權 IP。
374
378
 
375
379
  ### 端點
376
380
 
377
381
  ```
378
- POST /api/credit
382
+ POST /api/credit # Version 固定 1.3
379
383
  ```
380
384
 
381
385
  ### EncryptInfo 參數
@@ -383,40 +387,29 @@ POST /api/credit
383
387
  | 參數 | 類型 | 必填 | 說明 |
384
388
  |------|------|------|------|
385
389
  | `MerID` | String | ● | 商店代號 |
386
- | `MerTradeNo` | String | ● | 訂單編號 |
387
- | `TradeAmt` | Integer | ● | 交易金額 |
388
- | `Timestamp` | Integer | ● | Unix 時間戳 |
389
- | `CardNo` | String | ● | 信用卡號 (16 碼) |
390
- | `CardExpiry` | String | ● | 有效期限 `MMYY` |
391
- | `CardCVC` | String | ● | 安全碼 (3 碼) |
392
- | `ProdDesc` | String | 否 | 商品描述 |
393
- | `UsrMail` | String | 否 | 消費者 Email |
394
- | `NotifyURL` | String | 否 | 背景通知網址 |
395
-
396
- ### 分期付款參數
397
-
398
- | 參數 | 類型 | 說明 |
399
- |------|------|------|
400
- | `Inst` | Integer | 分期期數 `3`, `6`, `12`, `18`, `24`, `30` |
401
-
402
- ### 紅利折抵參數
403
-
404
- | 參數 | 類型 | 說明 |
405
- |------|------|------|
406
- | `Red` | String | 啟用紅利折抵 `Y` |
407
-
408
- ### 銀聯卡參數
409
-
410
- | 參數 | 類型 | 說明 |
411
- |------|------|------|
412
- | `UnionPay` | Integer | `1`:使用銀聯 |
413
-
414
- ### 信用卡約定 (Token) 參數
415
-
416
- | 參數 | 類型 | 說明 |
417
- |------|------|------|
418
- | `UseTokenType` | Integer | `1`:建立 Token `2`:使用既有 Token |
419
- | `BindVal` | String | Token 代碼 (UseTokenType=2 時必填) |
390
+ | `MerTradeNo` | String | ● | 訂單編號,長度 25,`[A-Za-z0-9_-]`,10 分鐘內不可重複 |
391
+ | `TradeAmt` | Integer | ● | 訂單金額 |
392
+ | `Timestamp` | Integer | ● | `time()` |
393
+ | `ProdDesc` | String | ● | 商品說明,長度 550,可用半形 `;` 分隔多項 |
394
+ | `UsrMail` | String | 條件 | 開啟物流時必填(視為收件人信箱);`CarrierType=amego` 時必填 |
395
+ | `CreditHash` | String | 否 | 首次 Token 交易回傳的 `CreditHash` |
396
+ | `CardInst` | String | 否 | `1` 一次(預設);`3`,`6`,`9`,`12`,`18`,`24`,`30` 分期 |
397
+ | `API3D` | Integer | 否 | `1` = 強制 3D |
398
+ | `EnName` | String | 否 | 3D 交易持卡人英文名稱 |
399
+ | `ReturnURL` | String | 否 | 僅 `API3D=1` 時使用,3D 完成後導回 |
400
+ | `NotifyURL` | String | 否 | 僅補觸發或回覆 `UNKNOWN` 後通知結果使用;限 80/443 port |
401
+ | `UserIP` | String | 否 | 消費者 IP(IPv4/IPv6),列入風險管控 |
402
+ | `BuyerHash` | String | 條件 | 買方會員 Token Hash;開放交易金額上限且金額超過訂單金額限制時必填 |
403
+ | `CarrierType` / `CarrierInfo` / `InvBuyerName` | String | 條件 | 需開立發票時帶入(`3J0002`、`CQ0001`、`amego`、`Donate`、`Company`) |
404
+
405
+ 開啟物流功能時可做取貨不付款(`ServiceType=3`),另帶 `Consignee`、`ConsigneeMobile`、`LgsType`(`B2C`/`C2C`/`HOME`)、
406
+ `GoodsType`、`ShipType`(`1` 7-ELEVEN、`2` 黑貓),以及 `StoreID`(超商)或 `ConsigneeAddress`、`DeliveryTimeTag`(黑貓)。
407
+
408
+ ### 回應
409
+
410
+ `Status`:`SUCCESS`、`UNKNOWN`(60 秒未收到銀行回應,結果之後 Notify 或 15 分鐘後以交易查詢確認)、`UNAPPROVED`。
411
+ EncryptInfo 內含 `TradeNo`、`TradeStatus`(`1` 已付款、`2` 失敗、`3` 取消、`8` 待確認)、`AuthCode`、`AuthType`(`1` 一次、`2` 分期、`7` 銀聯)、
412
+ `Card6No`、`Card4No`、`CreditHash`、`CreditLife`(`MMYY`)等。`API3D=1` 時回傳 `URL`(3D 導頁網址)。錯誤碼見官方 page 45。
420
413
 
421
414
  ---
422
415
 
@@ -616,9 +609,13 @@ POST /api/credit_bind/query
616
609
  | 參數 | 類型 | 必填 | 說明 |
617
610
  |------|------|------|------|
618
611
  | `MerID` | String | ● | 商店代號 |
619
- | `BindVal` | String | ● | Token 代碼 |
612
+ | `CreditToken` | String | 二擇一 | 信用卡 Token(如會員編號、Email),長度 200 |
613
+ | `CreditTokenType` | Integer | 否 | `1` 會員(預設)、`2` 商店;用 `CreditHash` 查詢時不用帶 |
614
+ | `CreditHash` | String | 二擇一 | 信用卡 Token Hash,長度 64 |
620
615
  | `Timestamp` | Integer | ● | Unix 時間戳 |
621
616
 
617
+ Version 固定 `1.0`。可能有多筆,解密後資料在 `Result` 陣列(`CreditHash`、`CreditTokenStatus` `1` 正常/`3` 刪除/`4` 逾期、`Card6No`、`Card4No` 等)。
618
+
622
619
  ### 取消約定信用卡
623
620
 
624
621
  #### 端點
@@ -632,7 +629,9 @@ POST /api/credit_bind/cancel
632
629
  | 參數 | 類型 | 必填 | 說明 |
633
630
  |------|------|------|------|
634
631
  | `MerID` | String | ● | 商店代號 |
635
- | `BindVal` | String | ● | Token 代碼 |
632
+ | `UseTokenType` | Integer | ● | `1` 綁定(`BindVal` 帶 `CreditHash`)、`2` 記憶卡號(`BindVal` 帶 `CreditToken`) |
633
+ | `BindVal` | String | ● | 依 `UseTokenType` 帶 `CreditHash` 或 `CreditToken` |
634
+ | `CreditTokenType` | Integer | 否 | `1` 會員(預設)、`2` 商店 |
636
635
  | `Timestamp` | Integer | ● | Unix 時間戳 |
637
636
 
638
637
  ---
@@ -3,10 +3,10 @@
3
3
  "displayName": "Antigravity / Generic Agent",
4
4
  "installType": "full",
5
5
  "folderStructure": {
6
- "root": ".agent",
6
+ "root": ".agents",
7
7
  "skillPath": "skills/taiwan-payment",
8
8
  "filename": "SKILL.md",
9
- "globalRoot": "~/.gemini/antigravity/global_skills"
9
+ "globalRoot": "~/.gemini/config"
10
10
  },
11
11
  "scriptPath": "skills/taiwan-payment/scripts",
12
12
  "frontmatter": {
package/dist/index.js CHANGED
@@ -15934,10 +15934,7 @@ async function generatePlatformFiles(targetDir, aiType, isGlobal = false) {
15934
15934
  const createdFolders = [];
15935
15935
  let skillDir;
15936
15936
  if (isGlobal) {
15937
- let skillPath = config.folderStructure.skillPath;
15938
- if (config.folderStructure.globalRoot?.includes("global_skills")) {
15939
- skillPath = skillPath.replace(/^skills\//, "");
15940
- }
15937
+ const skillPath = config.folderStructure.skillPath;
15941
15938
  skillDir = (0, import_node_path.join)(targetDir, skillPath);
15942
15939
  createdFolders.push(targetDir);
15943
15940
  } else {
@@ -16031,7 +16028,7 @@ function getAITypeDescription(aiType) {
16031
16028
  case "windsurf":
16032
16029
  return "Windsurf (.windsurf/skills/)";
16033
16030
  case "antigravity":
16034
- return "Antigravity (.agent/skills/)";
16031
+ return "Antigravity (.agents/skills/)";
16035
16032
  case "copilot":
16036
16033
  return "GitHub Copilot (.github/skills/)";
16037
16034
  case "kiro":
@@ -16324,7 +16321,7 @@ var PLATFORMS = [
16324
16321
  { name: "claude", folder: ".claude", description: "Claude Code (Anthropic)" },
16325
16322
  { name: "cursor", folder: ".cursor", description: "Cursor Editor" },
16326
16323
  { name: "windsurf", folder: ".windsurf", description: "Windsurf (Codeium)" },
16327
- { name: "antigravity", folder: ".agent", description: "Antigravity (Google)" },
16324
+ { name: "antigravity", folder: ".agents", description: "Antigravity (Google)" },
16328
16325
  { name: "copilot", folder: ".github", description: "GitHub Copilot" },
16329
16326
  { name: "kiro", folder: ".kiro", description: "Kiro (AWS)" },
16330
16327
  { name: "codex", folder: ".agents", description: "Codex CLI (OpenAI)" },
@@ -16358,7 +16355,7 @@ function listCommand() {
16358
16355
  var import_chalk5 = __toESM(require_source());
16359
16356
 
16360
16357
  // src/version.ts
16361
- var VERSION = "1.5.12";
16358
+ var VERSION = "1.5.13";
16362
16359
 
16363
16360
  // src/commands/info.ts
16364
16361
  async function infoCommand() {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "taiwan-payment-skill",
3
- "version": "1.5.12",
3
+ "version": "1.5.13",
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",