主题
查单
按商户单号:GET /v1/open/payments/{out_trade_no} 按平台单号:GET /v1/open/payments?payment_no=xxx(路径留空) 双号同传 → 400 PARAM_INVALID。
响应 data
| 字段 | 说明 |
|---|---|
status | pending / paid / closed / refunded;refunded = 累计退款 ≥ 实付(派生态,非状态机节点) |
paid_at | 支付成功时间(paid 时返回) |
closed_at / closed_reason | 关闭时间 / expired(超时)或 manual(人工) |
refunded_at | 退款完成时间(refunded 时返回) |
cashier_url | 仅 pending 返回(还可用于补拉起收银台) |
只读本地,不查渠道;建议作为回调失败时的兜底(日终按自有单号集合逐笔对账)。
订单状态字典
| 值 | 含义 | 触发 | 终态 |
|---|---|---|---|
pending | 待支付 | 创建成功 | 否 |
paid | 已支付 | 渠道回调/主动查单 | 是 |
closed | 已关闭 | 超时关单/人工 | 是(可被 paid 补单覆盖) |
refunded | 已退款 | 退款成功(查单派生态) | 是 |
closed → paid是唯一逆向迁移(渠道扣款晚于本地关单的补单);对方可能先收closed再收succeeded,以查单为准。