订阅、订单与退款

QuotaAPI 支持余额充值订单和订阅计划订单。两类订单都保留支付币种、USD 价值、支付服务商和状态快照，但完成后的权益不同。

余额与订阅的区别

类型	完成后获得	使用方式
余额充值	USD 账户余额	可用于符合权限的按量调用
订阅计划	指定分组、有效期和周期额度	仅用于计划绑定的分组和模型范围

订阅不是自动续费承诺。购买页显示的是一次购买的计划价格和有效期，是否提供后续续购以控制台当时展示为准。

订阅额度

计划可配置：

• daily_limit_usd：每日 USD 用量上限。
• weekly_limit_usd：每周 USD 用量上限。
• monthly_limit_usd：每月 USD 用量上限。
• 有效天数、目标分组、模型范围和倍率。

控制台的订阅页面会展示当前周期进度与剩余天数。某个周期达到上限时，只会限制该订阅在对应窗口内继续使用；周期重置后可恢复。订阅过期后不会再参与调度。

订单状态

状态	含义	用户动作
PENDING	等待支付	在过期前完成支付，或取消订单
PAID	服务商已确认支付	等待系统发放权益
RECHARGING	正在写入余额或订阅	不要重复支付，稍后刷新
COMPLETED	权益发放完成	核对余额或订阅
EXPIRED	超过支付时限	创建新订单，不要继续支付旧订单
CANCELLED	已取消	创建新订单
FAILED	支付或发放失败	查看错误并提交工单
REFUND_REQUESTED	用户已申请退款	等待管理员处理
REFUNDING / REFUND_PENDING	退款处理中	等待服务商最终状态
PARTIALLY_REFUNDED	已部分退款	核对退款金额与剩余权益
REFUNDED	已完成退款	核对原支付账户
REFUND_FAILED	退款失败	联系管理员

订单记录接口为 GET /api/v1/payment/orders/my，相对 API 路径是 /payment/orders/my。控制台会显示订单号、创建时间、USD 金额、实付币种和金额、支付方式与状态。

支付状态核验

支付页面会轮询订单状态，支付服务商回调也会推进订单。浏览器关闭或回跳失败不会自动丢失订单；重新打开订单列表后可主动刷新状态。

同一笔支付只应对应一个订单。不要在 PAID 或 RECHARGING 状态下重新付款，因为权益发放可能仍在后台重试。

取消与过期

只有仍为 PENDING 的订单可以由用户取消。订单到达 expires_at 后会自动过期；过期订单释放预留的优惠名额。支付服务商已经收款但本地状态滞后时，系统会优先核验真实支付状态，避免错误取消已支付订单。

用户退款申请

退款入口仅在以下条件同时满足时显示：

1. 支付服务商实例启用了退款。
2. 管理员允许用户申请退款。
3. 订单状态和剩余可退金额符合规则。
4. 用户填写退款原因。

提交申请只把订单推进到 REFUND_REQUESTED，并不代表已经退款。管理员审核并调用原支付服务商后，状态才会继续变化。跨币种订单按原订单的支付币种和汇率快照处理，到账时间取决于服务商和银行。

退款可能需要扣回对应 USD 余额、订阅权益或活动赠送。若账户已消耗相关权益，管理员可能无法直接完成全额退款。部分退款后仍可对剩余可退金额继续处理，具体以订单页面为准。

WARNING

不要用退款重新获取首充资格。系统把曾经进入 PAID 或后续状态的订单视为成功支付历史，即使后来退款，用户仍不再属于首充新用户。

排查订单问题

• PENDING 且未扣款：确认支付组件、币种、金额上下限和浏览器弹窗。
• 已扣款但仍 PENDING：刷新状态，等待服务商回调，不要重复支付。
• 长时间 RECHARGING：提交工单并提供订单号。
• FAILED：查看订单错误或支付服务商消息后重新创建订单。
• 退款长时间处理中：提供订单号和退款申请时间联系管理员。

充值币种和汇率说明见充值、支付与优惠。