接口概览
/orders/{id} 与 /orders/{id}/ 当前都可用。订单 ID 是支付链接的一部分,应视为敏感的不透明标识,不要公开传播。
匿名查询
支付页面在登录态丢失时可以直接读取:id、description、price、state、pay_way、pay_url、expired_at、created_at。它不会返回账户、Application、Package、支付内部标识或 metadata。
已认证查询
application / applications、package / packages、bank_details、invoice_automation 及模型字段。若已认证但不是订单所有者,返回 403;超级管理员除外。
关键字段
完整响应可能随支付方式附加字段,客户端应按需读取,并始终避免记录完整响应中的敏感 metadata。
错误处理
404:订单 ID 不存在。403:已登录但不是订单所有者。- 匿名请求不会返回
401;它只得到最小公开投影。
发票红冲与重新申请
通过GET /api/v1/orders/{order_id}/invoice/ 可读取订单当前的发票。自动红冲提交后,发票仍为 Issued,red_state 表示红冲进度;提交成功不等于红冲完成。等待确认、开具红票或归档期间,订单不能再次申请发票。
管理员因抬头或税号等开票信息错误申请红冲时,红冲原因为“开票有误”;订单退款触发的自动红冲仍使用“服务中止”。
红票开具并归档成功后,原发票变为 Voided,订单才可以重新申请。原发票可在发票历史中查看。红冲失败或结果待核实时,由财务核查处理,订单不会提前解除开票限制。人工开具的发票须先在税务或开票系统完成作废或红冲,再由财务在平台确认。

