woomp

ECPay 綠界科技 API 整合助手（官方 + zenbu-site 專案 NestJS/TypeScript 慣例補強）。 核心服務：AIO 全方位金流（導轉式）、ECPG 站內付 2.0（內嵌式 / 綁卡 / 幕後授權 / 幕後取號）、 CheckMacValue SHA256、AES-128-CBC 加密、電子發票（B2C/B2B/離線）、電子收據（一般/公益/政治獻金）、 超商取貨/全方位/跨境物流、ECTicket。 付款方式：信用卡（一次/分期/自費分期/定期定額）、ATM 虛擬帳號、CVS 超商代碼、BARCODE 超商條碼、 WebATM、Apple Pay、TWQR 行動支付、BNPL 先買後付（裕富/中租）、微信支付、銀聯、3D Secure 2.0。 進階功能：Token 綁卡、退款、折讓、對帳、發票作廢、物流追蹤、跨境物流。 整合情境：Shopify、WooCommerce、POS 刷卡機、直播收款。 支援 12 種程式語言（PHP/Python/Node.js/TypeScript/Go/Java/C#/Kotlin/Ruby/Rust/Swift/C/C++）。 本專案 zenbu-site 為 NestJS 11 + TypeORM 0.3 後端， ECPay 整合位於 apps/api-gateway/src/commerce/payments/ecpay/， 完整 NestJS/TypeScript 範例與專案實務陷阱見 references/zenbu-site/nestjs-typescript-integration.md。 當程式碼涉及以下任何情況時，必須使用此 skill： ECPay、綠界、ecpay、CheckMacValue、AioCheckOut、MerchantTradeNo、HashKey、HashIV、 ChoosePayment、ReturnURL、PaymentInfoURL、OrderResultURL、EncryptType、PeriodAmount、 CreditInstallment、ECPG、ecpg.ecpay.com.tw、ecpayment.ecpay.com.tw、payment.ecpay.com.tw、 apps/api-gateway/src/commerce/payments/ecpay/、台灣金流串接、超商代碼繳費、ATM

ezPay 電子發票（藍新金流 NewebPay 旗下品牌）API 完整技術參考，對應官方文件 EZP_INVI_1.2.1「電子發票技術串接手冊（標準版）」（簡單行動支付股份有限公司， 2021-04-01）。台灣電子發票服務商，涵蓋發票全生命週期：開立發票 （即時 / 等待觸發 / 預約自動，B2C / B2B，invoice_issue）、觸發開立發票 （invoice_touch_issue）、作廢發票（invoice_invalid）、開立折讓 （allowance_issue）、觸發確認 / 取消折讓（allowance_touch_issue）、 作廢折讓（allowanceInvalid）、查詢發票（invoice_search）。包含 AES-256-CBC 加密 PostData_（HashKey 32 bytes / HashIV 16 bytes / PKCS#7 padding / hex 輸出）、回應 CheckCode SHA256 驗證機制、載具類別 （手機條碼 0 / 自然人憑證 1 / ezPay 電子發票載具 2）、捐贈碼 LoveCode、 課稅別 TaxType、零稅率報關標記、含稅 / 未稅金額計算邏輯、完整錯誤碼表、 測試與正式環境 endpoint。Use this skill whenever code or tasks involve ezPay、ezpay、藍新電子發票、電子發票、cinv.ezpay.com.tw、inv.ezpay.com.tw、 開立發票、發票作廢、折讓單、開立折讓、作廢折讓、查詢發票、PostData_、 MerchantID_、CheckCode、HashKey、HashIV、CarrierType、載具、LoveCode、 捐贈碼、TaxType、課稅別、invoice_issue、invoice_touch_issue、 invoice_invalid、allowance_issue、allowance_touch_issue、allowanceInvalid、 invoice_search、e-invoice integration、台灣電子發票串接，或在 zenbu-site apps/api-gateway/src/commerce/ 下整合 ezPay 電子發票開立。 本 SKILL 為唯一官方 API reference

NewebPay MPG (Multiple Payment Gateway) complete payment gateway reference for Taiwan, aligned with official NDNF-1.2.2 manual (revised 2026-04-21). Covers MPG Version 2.0 (legacy) and 2.3 (current spec): AES-256-CBC + SHA256 encryption, optional AES-256-GCM (EncryptType=1), all TradeInfo parameters, payment methods (credit card / WebATM / VACC / CVS / BARCODE / CVSCOM / LINE Pay / Apple Pay / TWQR / smart-ATM 2.0 / AFTEE BNPL / e-wallets), callback handling, query trade, credit card close/cancel/refund, e-wallet refund, BNPL refund (NPA-B07) and BNPL settle (NPA-B62), error codes, sandbox endpoints. Use this skill whenever code involves newebpay, TradeInfo, TradeSha, EncryptData_, HashData_, MerchantID + HashKey + HashIV, ccore.newebpay.com / core.newebpay.com (and legacy spgateway.com aliases), MPG/mpg_gateway, /API/QueryTradeInfo, /API/CreditCard/Close, /API/CreditCard/Cancel, /API/EWallet/refund, /API/Bnpl/refund, /API/Bnpl/settle, NewebpayService, newebpay callback/notify handling, AFTEE 先買後付, TWQR 跨機構支付

PayNow（立吉富，paynow.com.tw）台灣第三方支付 + 電子發票服務商 API 完整技術參考， 對應官方文件 docs.paynow.com.tw（2026 最新版）。PayNow 同時存在兩代金流串接： (1) 新版 REST API — PaymentIntent 付款意圖 + Component SDK v2（iframe 內嵌）+ Bearer Token（PrivateKey）認證 + HMAC-SHA256 Webhook 驗簽；端點 api.paynow.com.tw / sandboxapi.paynow.com.tw（建立/查詢/執行付款意圖、退款開立/查詢/列表、 Customer 綁卡 Token、ApplePay session、3DS/OTP session、Partner 商戶綁定）。 (2) 舊版 CashFlow API — HTTP form-post etopm.aspx 導轉式 + 背景交易 PayNowAPI_JS.aspx （請款 CP_gp / 退款 R_gp / 取消授權 CPA_gp / 交易查詢 PQS_gp / 票券核銷 T_S T_G）； 簽章用 SHA-1 PassCode、AES256（檢核碼 GP/GK 換鑰）、HMAC-SHA256、TripleDES； 端點 www.paynow.com.tw / test.paynow.com.tw；付款方式信用卡/WebATM/虛擬帳號/超商代碼 (ibon/FamiPort/icash)/超商條碼/銀聯/分期/自動扣款/ApplePay。 (3) 電子發票 API — Bearer Token；端點 invoiceapi-prod.paynow.com.tw / invoiceapi-dev.paynow.com.tw（開立 /api/invoices/issue、作廢 /api/invoices/cancel、 折讓 /api/invoices/allowance、折讓作廢 /api/invoices/cancel-allowance、 查詢 GET /api/invoices、POS 取號 + POS 開立）；載具 carrier_type、捐贈碼 npoban、 課稅別 tax_type、零稅率原因 zero_tax_rate_reason。 Use this skill whenever

PAYUNi 統一金流物流工具 V3 完整 API 參考（依據 docs.payuni.com.tw 官方文件 2026-05-04 版重新爬取）。 涵蓋 7-ELEVEN 超商 B2C/C2C/C2B 物流（建立物流單 v1.3、超商門市地圖 v1.1、出貨單列印 v1.0、 退貨便要號 v1.0、店到店轉宅配 v1.0）、黑貓宅配物流（建立宅配單 v1.2、產宅配編號並下載託運單 PDF v1.0、 下載託運單 PDF v1.0、呼叫黑貓 v1.0、建立宅配退貨單 v1.0）、物流單查詢 v1.1、物流單修改 v1.1， 以及 AES-256-GCM + SHA256 加密規範（與 PAYUNi 金流共用）、官方完整錯誤碼表（450+ 條）、 物流貨態狀態碼（91/92/98/21/22/31/32/33/11/41/43/44/46/51/52/53/55/56/81/82）、 超商物流貨態 Notify v1.0 與 宅配貨態 Notify v1.0。 Use this skill whenever the task involves PAYUNi 物流、payuni-logistics、shipping、CVS pickup、 超商取貨、7-ELEVEN B2C/C2C/C2B、Tcat、黑貓宅配、ship_map、ShipTradeNo、ShipStatus、 c2c_to_home_delivery、call_cat、退貨便、託運單 PDF、物流 Notify callback、 或任何 import from 'payuni-logistics' / 'payuni-crypto' / 涉及 ZenbuSite shippingRef、 shippingProvider=payuni、shippingStoreId、shippingOdno、ShipStatus mapping 的程式碼。 本 SKILL 為唯一官方 API reference 來源——不要再去翻 docs.payuni.com.tw。

PAYUNi UNi Embed (免跳轉支付元件 / 內嵌式金流) API Ver 3.0 + JS SDK Ver 2.0 完整技術參考。 iframe 嵌入式信用卡收單，站內付不跳轉，後端 token_get 取 SDK_TOKEN，前端 uniPayment.js 收集卡片資訊取得綁定結果，後端再呼叫 merchant_trade 完成幕後授權。 當程式碼涉及 PAYUNi、統一金流、payuni-uni、UNi Embed、內嵌金流、站內付、tokenization、 iframe 信用卡收單、SDK 整合、uni-payment.js、createSession、getTradeResult、 iframe/token_get、iframe/merchant_trade、IFrameDomain、SDK_TOKEN 時使用。 與 payuni-upp-v3（導轉式整合支付頁）平行；加密規則（AES-256-GCM + SHA256 HashInfo） 與 UPP 完全一致，請參考 payuni-upp-v3 該段。本 SKILL 為 V3 (2025/09 釋出)， 若程式碼出現 V2 或 V1 路徑，請勿混用——V3 token_get 階段不送訂單資料。

PAYUNi UPP V2 (UNiPaypage Version 2.0) 統一金流整合支付頁完整技術參考。 涵蓋 AES-256-GCM 加解密、SHA256 HashInfo、UPP 請求/回傳參數、所有付款方式 (信用卡/分期/紅利/Apple Pay/Google Pay/Samsung Pay/銀聯/ATM 虛擬帳號/超商代碼/ icash Pay/AFTEE/LINE Pay/街口支付/貨到付款/宅配)、信用卡 Token / 買方 Token、 優惠券、物流參數、交易查詢/請退款/取消授權、Token 查詢/取消、Sandbox 測試。 當程式碼涉及 PAYUNi、統一金流、payuni、UPP、UNiPaypage、台灣金流、 EncryptInfo HashInfo、信用卡分期、超商代碼、ATM 虛擬帳號、LINE Pay、 街口支付、AFTEE、icash Pay、Apple Pay、Google Pay、Samsung Pay、 /api/upp、/api/trade/query、/api/trade/close、/api/trade/cancel、 /api/credit_bind、/api/cancel_cvs、/api/aftee_direct 等端點時必須使用。 V2 專用 (Version 2.0、AES-256-GCM)，PAYUNi 官方目前 UPP 僅有 V2，沒有 V3。 與舊版 V1.x (AES-256-CBC) 不相容。

PAYUNi UNi Embed 免跳轉支付元件開發參考。涵蓋 SDK 整合、API 規格、AES-256-GCM 加解密、信用卡記憶（Tokenization）、發票載具、分期付款。當開發、除錯或擴充 PAYUNi 支付功能時使用此 SKILL。

Woomp WooCommerce 台灣在地化外掛開發指引。涵蓋 PayUni/綠界/藍新/立吉富金流、超商物流、電子發票整合架構與模組載入機制。開發、除錯或擴充 woomp 外掛任何模組時使用。