跳转到主要内容
通过订单 ID 查询订单。该端点支持两种读取模式:匿名访问只返回支付页所需的最小字段;订单所有者携带 Account Token 时返回完整详情。

接口概览

/orders/{id} 与 /orders/{id}/ 当前都可用。订单 ID 是支付链接的一部分,应视为敏感的不透明标识,不要公开传播。

匿名查询

支付页面在登录态丢失时可以直接读取:
匿名响应只包含 id、description、price、state、pay_way、pay_url、expired_at、created_at。它不会返回账户、Application、Package、支付内部标识或 metadata。

已认证查询

订单所有者会收到完整 Order 详情,包括 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,订单才可以重新申请。原发票可在发票历史中查看。红冲失败或结果待核实时,由财务核查处理,订单不会提前解除开票限制。人工开具的发票须先在税务或开票系统完成作废或红冲,再由财务在平台确认。

相关接口