ccatpay Payment for WooCommerce

By ccatpay

10+ active installationsVersion 2.11.1

Adds ccatpay (黑貓Pay) payment gateways and shipping services to WooCommerce.

Description

ccatpay Payment for WooCommerce integrates Taiwan local payment and shipping services:

  • Credit Card payments
  • Convenience store barcode/code payments (ibon)
  • Virtual Account transfer (ATM)
  • Delivery and 7-Eleven pickup services

Features:

  • Electronic invoice issuance support
  • WooCommerce Blocks integration
  • Traditional Chinese interface

Third-party Resources

  1. JsBarcode – https://github.com/lindell/JsBarcode
    Version: 3.11.6
    License: MIT
    本地副本包含在 resources/js/frontend/JsBarcode.all.min.js

Support

  • 使用手冊下載
  • 如需技術支援請聯繫客服:02-8752-0688

Installation

自動安裝

  1. 前往 [外掛]→[安裝外掛]。
  2. 搜尋「ccatpay」或「黑貓Pay」。
  3. 安裝並啟用 ccatpay Payment for WooCommerce 外掛。

手動安裝

  1. 上傳 ccat-for-woocommerce 資料夾至 /wp-content/plugins/ 目錄
  2. 在後台啟用插件
  3. 前往 WooCommerce > 設定 > 黑貓Pay 設定您的金流

FAQ

支援哪些 WooCommerce 版本?

本插件支援 WooCommerce 9.8 至 11.0.1 版本。

如何設定電子發票?

前往 WooCommerce > 設定 > 黑貓Pay > 發票設定 啟用並設定。

Changelog

1.0.0

  • 新增:黑貓PAY金流服務

2.0.0

  • 新增:黑貓宅配、快速到店

2.0.1

  • 修正:使用黑貓物流時,電話為必填。選擇7-11取貨的時候,將門市地址自動填上地址表單。

2.0.2

  • 新增:支援最新版 WordPress 6.8、WooCommerce 9.8

2.0.3

  • 修正:提醒託運單格式,黑貓快速到店(711取貨)對應A4三模託運單,黑貓宅配則是對應A4二模託運單。

2.0.4

  • 修正:文字調整,物流訂單 更改為 物流託運單。

2.1.0

  • 修正:因應WordPress外掛商店上架調整程式碼。

2.1.1

  • 修正:修正I18n.NonSingularStringLiteralDomain問題。

2.1.2

  • 改進:依照官方審核要求調整變數名稱。

2.2.1

  • 新增:後台列印黑貓宅配託運單時,可選擇希望配達時段

2.3.1

  • 新增:後台列印運單時,可選擇託運單類別

2.3.2

  • 修正:後台列印運單時,提醒託運單格式

2.3.3

  • 修正:711電子地圖視窗大小調整

2.3.4

  • 修正:訂購人電話改帶入get_billing_phone,沒有get_billing_phone才改用get_shipping_phone

2.3.5

  • 修正: 未定義變數 $schema 錯誤

2.3.6

  • 修正: get_invoice_data、get_invoice_schema錯誤

2.3.7

  • 修正: 後台付款方式設定,增加付款說明欄位

2.3.8

  • 修正: 後台運送方式設定,開放運費擴充欄位
  • 修正: 調整消費者沒有填配送方式的聯絡電話時,印單時就改抓帳單的聯絡電話
  • 改進: 收到APN資訊,有發票號碼才寫入訂單備註紀錄

2.3.9

  • 修正: 列印黑貓宅配單,補上郵遞區號及縣市區資料

2.3.10

  • 修正: 列印託運單的收件人資料,改成只從shipping中取得資料

2.4

  • 修正: 關閉行動支付(OPW/iCash/宅配貨到手機支付)

2.5

  • 修正: 列印託運單的希望配達日,如果計算結果當天是星期日,則順延到星期一

2.6

  • 改進: 調整 Ibon 支付流程,改為在結帳完成頁面顯示支付按鈕而非自動轉址。

2.6.1

  • 改進: 調整 Ibon 支付流程,當沒有短網址時,改為在結帳完成頁面顯示直接回傳的 Ibon 繳款代碼。
  • 改進: 調整 ATM 支付流程,當沒有虛擬帳號但有短網址時,改為在結帳完成頁面顯示支付按鈕而非自動轉址。

2.6.2

  • 修正: 修復相容 WordPress / WooCommerce 預設顧客位置過濾器傳入型態不一致產生的 TypeError 致命錯誤。
  • 修正: 修復 get_payment_api_token 快取型態為陣列時觸發的 TypeError 致命錯誤。
  • 修正: 解決安裝快取套件時 API Token 可能無法自動刷新及清除的問題。

2.6.3

  • 改進: 當「啟用黑貓物流」關閉時,停用運算與後台運送設定,並限制訂單託運單建立,同時保留歷史託運單下載功能。

2.7

  • 新增: 後台訂單管理支援建立複數件託運單,並依貨到付款規則自動設定代收金額。
  • 改進: 支援相容至最新版 WooCommerce 11.0.1。

2.8

  • 新增: WooCommerce 後台訂單管理支援「批次列印託運單」功能,自動分流宅配與 7-11 訂單,過濾已列印訂單並整合下載 PDF。
  • 新增: WooCommerce 後台訂單列表新增「黑貓物流」自訂欄位,即時呈現運送方式、溫層、門市名稱與印單狀態標籤(支援HPOS)。

2.8.1

  • 修正: 移除玉山信用卡支付方式。

2.9

  • 改進: 貨到付款(現金、刷卡) 改為獨立模組,並完善 WooCommerce Checkout Blocks 可獨立顯示貨到付款(現金、刷卡)各自的付款方式。

2.9.1

  • 改進: 升級 WooCommerce 結帳區塊 API 版本至 apiVersion 3,支援 WordPress 7.0+ iframe editor。
  • 修正: 解決 Plugin Check 掃描問題,補齊多語系註解、時區格式與安全輸出規範。
  • 改進: 支援最新 WordPress 7.1 與更新外掛官方規範說明。

2.10

  • 新增: WooCommerce 後台「分析 (Analytics) > 訂單 (Orders)」下載 CSV 功能增加黑貓物流資訊。
  • 新增: 後台「黑貓Pay」設定新增 ATM / ibon 繳款期限天數自訂欄位,支援設定 0 天(當天有效)且預設為 7 天。
  • 改進: 改善程式碼變數名稱的獨特性,避免跟其他外掛有衝突。

2.11

  • 修正: 強化付款通知 (APN Callback) 安全性驗證,強制核對商店代號 (api_id)、訂單金額 (amount / pay_amount) 與建單紀錄。
  • 修正: 訂單編號 (order_no) 加入隨機碼防止外部推算,並防止已付款訂單被退回未付款或重複觸發完成付款。
  • 新增: 後台「黑貓Pay」設定新增「允許的付款通知(APN)來源IP」白名單欄位(預設空白不阻擋來源 IP)。

2.11.1

  • 新增: 調整程式穩定性。