=== Cregis Payment for WooCommerce ===
Tags: cryptocurrency, payment, woocommerce, cregis, crypto payment
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Cregis Payment for WooCommerce 是 Cregis Payment Engine (https://support.cregis.com/cregis-wallet-guide/zh-tw/payment_engine/introduction) 為 WooCommerce 商戶提供的支付插件。安裝及完成設定後，商戶即可於 WooCommerce 網店接收加密貨幣付款，並透過 Cregis 支付閘道建立訂單、查詢付款狀態及接收付款結果通知。

== Description ==

= 支援的加密貨幣 =

USDT、USDC、BTC、SOL、ETH、TRX、BNB

= 主要功能 =

* 支援使用 USDT、USDC、BTC、SOL、ETH、TRX 及 BNB 付款
* 支援多條區塊鏈網絡
* 可設定少付及多付的金額容差
* 透過 webhook 自動同步訂單狀態
* 為少付及多付訂單提供獨立結果頁面
* 提供除錯模式，方便排查問題
* 兼容 WooCommerce Blocks

= 系統要求 =

* WordPress 5.0 或以上版本
* WooCommerce 3.0 或以上版本
* 已開通的 Cregis 商戶帳戶，以及 Project ID 和 Secret Key

== 外部服務 ==

本插件需要連接 Cregis API，以建立加密貨幣付款訂單及查詢付款狀態。

傳送的資料及傳送時機

顧客選擇使用 Cregis Payment 結帳時，以下資料會傳送至 Cregis API (https://api.cregis.com)：

* 訂單編號及訂單金額
* 顧客的帳單電郵地址
* 支援的加密貨幣設定
* 付款容差設定
* 付款成功、取消及回調網址

資料會在以下情況傳送：

* 結帳時建立新的付款訂單
* 於返回頁面查詢付款狀態
* 接收付款 webhook 通知

各接口可能傳送的資料

* order_id：唯一訂單識別碼
* order_amount：訂單總金額
* order_currency：貨幣代碼，例如 USD
* payer_id：用戶 ID 或「guest」
* payer_email：顧客的帳單電郵地址
* valid_time：付款有效期，以分鐘計算
* tokens：支援的加密貨幣，採用 JSON 陣列格式
* underpaid_tolerance / overpaid_tolerance：少付及多付的容差金額
* callback_url：接收付款通知的 webhook 網址

服務供應商

Cregis (https://cregis.com)：加密貨幣支付閘道服務供應商。

* 服務條款：Cregis 標準服務條款 (https://support.cregis.com/cregis-wallet-guide/zh-tw/terms_and_conditions/cregis-standard-terms-of-service?fallback=true)
* 私隱政策：私隱政策及個人資料收集聲明 (https://support.cregis.com/cregis-wallet-guide/zh-tw/terms_and_conditions/personal_information_collection_statement)

== 關於 Cregis ==

Cregis 成立於 2017 年，總部位於香港，是一家面向企業的數字資產基礎設施平台。過去九年間，Cregis 已服務全球 50 多個國家和地區的 4,000 多家企業客戶，涵蓋加密貨幣交易所、金融科技公司、支付服務商、數字銀行、經紀商及 Web3 企業等機構。

圍繞企業數字資產營運需求，Cregis 構建了涵蓋錢包基礎設施（WaaS）、資金流編排（Rails）及合規託管能力（Custody）的產品體系，協助企業完成從資產存放與控制、資金流轉與營運，到管治與合規管理的完整閉環。

其中，核心產品 Wallet-as-a-Service 和 Payment Engine 已廣泛應用於企業級數字資產營運場景。隨着數字資產基礎設施需求持續全球化，Cregis 始終專注於一件事：協助企業以更強的控制力、更低的營運複雜度及更完善的合規能力使用數字資產。

== FAQ ==

= 是否需要 Cregis 帳戶？ =

需要。請先在 Cregis (https://cregis.com) 註冊帳戶，並取得 Project ID 及 Secret Key。

= 支援哪些加密貨幣？ =

USDT、USDC、BTC、SOL、ETH、TRX、BNB。

= 如果顧客支付的金額低於訂單總額，應如何處理？ =

有關少付訂單的處理方式及容差設定，請參閱 Cregis Payment Engine 產品手冊 (https://support.cregis.com/cregis-wallet-guide/zh-tw/payment_engine/introduction)。

= 如果顧客支付的金額超過訂單總額，應如何處理？ =

有關多付訂單的處理方式及退款流程，請參閱 Cregis Payment Engine 產品手冊 (https://support.cregis.com/cregis-wallet-guide/zh-tw/payment_engine/introduction)。

== Changelog ==

= 2.0.2 =
* 新增：在設定中顯示伺服器 IP 位址，附帶複製按鈕，方便設定 IP 白名單

= 2.0.1 =
* 新增：多語言支援（簡體中文和繁體中文）
* 修復：容差值現在格式化為雙精度數（例如 1.0、1.2 而不是 1.00）
* 修復：訂單金額、少付容差和多付容差四捨五入到最多 6 位小數
* 修復：API 錯誤訊息現在直接顯示給使用者
* 更改：設定中的「Gateway Server」重新命名為「Base URL」

= 1.4.0 =
* Fixed: CSS/JS enqueue using WordPress best practices
* Fixed: XSS vulnerabilities in return page handling
* Fixed: Generic prefix naming to avoid conflicts
* Fixed: Direct file access security

= 1.3.0 =
* (Initial release after review fixes)

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial release
