充值、支付与优惠
充值页面的核心原则是：账户到账和余额始终按 USD 记账，支付方式可以使用另一种币种完成收款。 页面会在创建订单前同时显示到账金额和实际支付金额。
三种金额不要混淆
| 字段 | 含义 | 示例 |
|---|---|---|
| 充值本金 | 用户选择的 USD 金额 | USD 10.00 |
| 到账金额 | 本金乘充值倍率，再加活动赠送 | USD 15.00 |
| 实付金额 | 本金与手续费按支付币种换算后的金额 | HKD 78.60 |
CNY 切换仅用于模型价格和页面参考价展示。它使用缓存的 USD/CNY 汇率，不会把账户余额改成人民币。订单中的 currency、payment_currency、credited_currency、fx_rate 和 fx_source 用于区分支付币种与 USD 到账币种。
支付方式
实际可用方式由管理员配置、地区、设备和支付服务商共同决定，以充值页显示为准。
| 页面方式 | 内部类型 | 常见支付币种 | 说明 |
|---|---|---|---|
| 银行卡 | stripe_card | USD | 在页面内完成卡支付 |
| Link | stripe_link | USD | 仅在 Stripe 和当前浏览器满足条件时显示 Link 组件 |
| 支付宝 | stripe_alipay | HKD | 香港 Stripe 本地钱包默认按 HKD 收款 |
| 微信支付 | stripe_wechat_pay | HKD | 香港 Stripe 本地钱包默认按 HKD 收款 |
| 加密货币 | crypto 及具体资产类型 | 按订单报价 | 页面给出资产、网络、地址和精确数量 |
系统也可接入独立支付宝、微信、聚合支付或其他服务商。没有显示的方式通常表示实例未启用、金额不满足上下限、当日限额已满，或当前环境不满足服务商要求。
汇率如何工作
对于 USD 余额、HKD 实收的订单，系统会：
- 自动读取内置实时汇率来源并缓存结果。
- 实时来源失败时使用管理员配置的 USD/HKD 兜底汇率。
- 应用管理员设置的汇率加点。
- 在创建订单时锁定本单汇率和来源，后续汇率变化不会修改已创建订单。
- 按支付币种允许的小数位向上取整，避免少收；USD 到账本金不受换算舍入影响。
示例：充值 USD 1.00，锁定汇率为 7.86，且没有额外手续费时，实际支付 HKD 7.86，基础到账仍是 USD 1.00。
如果实时与兜底汇率都不可用，系统会拒绝创建订单，而不是按 0 或过期价格收款。
充值优惠
充值页会在用户尚未选择金额或支付方式时展示当前可用的公开活动。活动停止、暂停、到期、用量耗尽或预算耗尽后会自动消失。仅优惠码可见的活动不会出现在公开横幅中。
常见规则：
- 固定赠送：充值满足条件后额外到账固定 USD 金额。
- 比例赠送：按充值本金赠送一定比例，例如充值 USD 100 赠送 50%。
- 首充活动：仅没有任何已支付或已进入后续状态订单的用户可用；退款不会恢复首充资格。
- 老用户活动：仅已经完成过支付的用户可用。
- 条件范围：可限制金额、用户组、支付方式、订阅计划、活动时间和每人次数。
系统只会选择一个最优可用活动，不会叠加多个活动。优先比较实际优惠金额，再比较活动优先级与创建时间。输入优惠码后，可在创建订单前看到是否有效、实付 USD、赠送或折扣以及最终到账金额。
前端用于获取公开活动的接口是 GET /api/v1/payment/promotions/available；相对 API 路径为 /payment/promotions/available。
TIP
活动名额在订单创建时预留，订单取消、过期或创建失败会释放；支付完成后才正式消耗。不要用多个待支付订单占用同一首充活动。
加密货币注意事项
- 严格按页面显示的资产、网络、地址和精确数量支付。
- 少付、过期后付款或转错网络通常无法自动到账。
- 链上确认可能较慢，不要因为页面暂未完成就重复转账。
- 异常订单请保留订单号和交易哈希并提交工单。
支付后没有到账
- 打开订单页面查看状态，不要重复支付。
- 对仍为待支付的订单使用“查询/刷新状态”。
- 确认浏览器没有拦截支付弹窗或回跳。
- 链上支付确认网络和精确金额。
- 已扣款但订单长时间未完成时，携订单号提交工单。
订单状态与退款规则见订阅、订单与退款。