支付配置
Novaix 集成了多种支付渠道，支持国内和国际用户的支付需求。所有支付配置都在管理面板的「系统设置」中完成，配置后立即生效，无需重启程序。每个支付渠道都有独立的启用开关，您只需配置并启用需要的渠道即可。
支持的支付渠道
支付宝
支持支付宝电脑网站支付，采用证书模式配置，需要准备以下信息：
| 字段 | 说明 |
|---|---|
| App ID | 支付宝开放平台应用 ID |
| 应用私钥 | RSA2 应用私钥 |
| 应用公钥证书 | 应用公钥证书内容（appCertPublicKey_*.crt） |
| 支付宝公钥证书 | 支付宝公钥证书内容（alipayCertPublicKey_RSA2.crt） |
| 支付宝根证书 | 支付宝根证书内容（alipayRootCert.crt） |
| 沙箱模式 | 是否使用沙箱环境（测试用） |
TIP
您需要在支付宝开放平台创建应用，选择公钥证书方式签名，下载三个证书文件后将内容填入对应字段。
微信支付
支持微信 Native 支付（扫码支付），需要准备以下信息：
| 字段 | 说明 |
|---|---|
| AppID | 微信公众号或开放平台应用 ID |
| 商户号 | 微信支付商户号 |
| API v3 密钥 | 商户平台设置的 API v3 密钥 |
| 商户证书序列号 | 商户 API 证书序列号 |
| 商户私钥 | 商户 API 私钥 |
| 微信支付公钥 ID | 微信支付平台公钥 ID |
| 微信支付公钥 | 微信支付平台公钥内容 |
Stripe
支持国际信用卡/借记卡支付，适合面向海外用户的场景：
| 字段 | 说明 |
|---|---|
| Secret Key | Stripe 密钥（以 sk_ 开头） |
| Webhook Secret | Webhook 签名密钥（以 whsec_ 开头） |
Webhook 配置
在 Stripe Dashboard 中添加 Webhook 端点：
- 点击「添加端点」
- 端点 URL 填写：
https://您的域名/api/callbacks/stripe - 选择监听事件：
checkout.session.completed - 创建后复制端点的「签名密钥」（以
whsec_开头），填入 Novaix 的「Webhook Secret」字段
TIP
如果您的业务涉及银行转账等异步支付方式，还需额外添加 checkout.session.async_payment_succeeded 事件。普通信用卡/借记卡支付只需 checkout.session.completed 即可。
最低金额限制
Stripe 对每笔交易有最低金额要求，具体取决于结算货币（如 USD 最低 $0.50、GBP 最低 £0.30）。跨币种支付时，Stripe 会按结算货币的最低额校验。如果充值金额低于最低限制，Stripe 会拒绝创建支付会话。请避免设置过低的套餐价格或充值金额。详见 Stripe 最低金额说明。
PayPal
支持 PayPal 国际支付：
| 字段 | 说明 |
|---|---|
| Client ID | PayPal 应用客户端 ID |
| Secret | PayPal 应用密钥 |
| Webhook ID | PayPal Webhook 端点 ID，用于验证回调签名 |
| 结算货币 | 支持 USD、EUR、GBP、JPY、CNY，默认 USD |
| 沙盒模式 | 是否使用沙盒环境（测试用） |
易支付
支持易支付通用接口规范（兼容彩虹易支付、ZPAY 等平台），适用于对接第三方聚合支付：
| 字段 | 说明 |
|---|---|
| 接口地址 | 易支付平台的 API 地址（无需包含 /submit.php） |
| 商户 ID | 商户编号 |
| 商户密钥 | MD5 签名密钥 |
| 支付方式 | 支持多选（支付宝、微信支付、QQ 钱包、网银、京东支付、PayPal、USDT），选择多种时用户下单时可自行选择 |
| 接口模式 | 页面跳转（默认）或 API 直接出码 |
易支付支持两种接口模式：
- 页面跳转：用户点击支付后跳转到支付平台的收银台页面，选择支付方式完成支付
- API 直接出码（MAPI）：系统直接调用支付平台的 MAPI 接口获取二维码，在页面内展示给用户扫码支付，无需跳转。需要支付平台支持 MAPI 接口
TIP
配置多种支付方式后，用户在充值或下单支付时会看到具体的支付方式选项（如"支付宝"、"微信支付"），而非笼统的"易支付"。如果只配置了一种支付方式，则直接以该方式的名称展示。
支付完成后，系统通过异步回调自动更新订单状态。
充值设置
在 设置 → 充值 中可以配置最小充值金额。系统默认最低充值 1 元，管理员可以设置更高的金额来抬高充值门槛。设为 0 表示使用系统默认值（1 元）。
支付流程
下图展示了用户从下单到支付完成的完整流程：
回调地址
每个支付渠道都有对应的回调地址，用于接收支付结果通知。请确保您的反向代理正确转发了这些请求：
| 渠道 | 回调地址 |
|---|---|
| 支付宝 | https://您的域名/api/callbacks/alipay |
| 微信支付 | https://您的域名/api/callbacks/wechat |
| Stripe | https://您的域名/api/callbacks/stripe |
| PayPal | https://您的域名/api/callbacks/paypal |
| 易支付 | https://您的域名/api/callbacks/epay |
WARNING
回调地址必须能从公网访问，且必须使用 HTTPS。如果支付后订单状态没有自动更新，请先检查回调地址是否可以正常访问。