订单链路探针

商户通过该接口，可通过输入业务订单号（PayOrder/RefundOrder），穿透查询该笔订单在资金清结算体系下的全生命周期流转状态及费率扣除节点。

接口信息

接口

请求API: /api/v2/recon/order-trace

请求方式: GET

请求参数

字段名	变量名	必填	类型	示例值	描述
订单号	orderId	是	String	PO_20260624_01	商户原始支付系统订单号或退款号

返回参数

返回一个数组（List），包含与该业务单号绑定的所有流转链路（例如：正向收款与反向退款可能返回两个独立链路）。

字段名	变量名	必填	类型	示例值	描述
快照ID	snapshotId	是	long	6001	资金快照ID
订单类型	orderType	是	String	PAY	订单类型: PAY(收款), REFUND(退款)
订单号	orderId	是	String	PO_20260624_01	原始业务订单号
归集日期	logDate	否	String(10)	2026-06-24	资金归集到账户池的日期（若未结算则为空）
入账金额	settlementAmount	否	long	50000	实际入账金额，单位：微单元
当前状态	currentNode	是	String	SETTLED	当前流转节点：PENDING(处理中), UNSETTLED(待提现), APPLYING(提现中), SETTLED(已结算)
费率节点明细	feeNodes	否	List		各种网关费、商户费、争议费的数组（解析自 JSON）

feeNodes 数据格式

字段名	变量名	必填	类型	示例值	描述
费用名称	feeName	是	String	GatewayFee	费用类型，如 GatewayFee, MchFee, RefundFee
费用金额	amount	是	long	100	该项扣除或增加的微单元金额
币种	currency	是	String	USD	计费币种