=== 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-cn/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-cn/terms_and_conditions/cregis-standard-terms-of-service)
* 隐私政策：隐私政策及个人资料收集声明 (https://support.cregis.com/cregis-wallet-guide/zh-cn/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-cn/payment_engine/introduction)。

= 如果客户支付的金额超过订单总额，该如何处理？ =

有关多付订单的处理方式及退款流程，请参阅 Cregis Payment Engine 产品手册 (https://support.cregis.com/cregis-wallet-guide/zh-cn/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
