Skip to content

查单

按商户单号:GET /v1/open/payments/{out_trade_no} 按平台单号:GET /v1/open/payments?payment_no=xxx路径留空) 双号同传 → 400 PARAM_INVALID。

响应 data

字段说明
statuspending / paid / closed / refundedrefunded = 累计退款 ≥ 实付(派生态,非状态机节点)
paid_at支付成功时间(paid 时返回)
closed_at / closed_reason关闭时间 / expired(超时)或 manual(人工)
refunded_at退款完成时间(refunded 时返回)
cashier_urlpending 返回(还可用于补拉起收银台)

只读本地,不查渠道;建议作为回调失败时的兜底(日终按自有单号集合逐笔对账)。

订单状态字典

含义触发终态
pending待支付创建成功
paid已支付渠道回调/主动查单
closed已关闭超时关单/人工是(可被 paid 补单覆盖)
refunded已退款退款成功(查单派生态)

closed → paid 是唯一逆向迁移(渠道扣款晚于本地关单的补单);对方可能先收 closed 再收 succeeded以查单为准

退款状态字典见退款;外发事件见回调通知