# V2 Order Trace
Merchants can use this API to pass in a business order ID (PayOrder / RefundOrder) and penetrate through the fund clearing and settlement system to view the full lifecycle flow status and fee deduction nodes of the order.
# API Information
API
Request API: /api/v2/recon/order-trace
Method: GET
# Request Parameters
| Field Name | Variable | Required | Type | Example | Description |
|---|---|---|---|---|---|
| Order ID | orderId | Yes | String | PO_20260624_01 | Merchant's original PayOrder or RefundOrder ID |
# Response Parameters
Returns a List (Array) containing all transaction chains bound to the order ID (e.g., forward pay-ins and reverse refunds may return as two independent chains).
| Field Name | Variable | Required | Type | Example | Description |
|---|---|---|---|---|---|
| Snapshot ID | snapshotId | Yes | long | 6001 | Fund snapshot ID |
| Order Type | orderType | Yes | String | PAY | Order Type: PAY, REFUND |
| Order ID | orderId | Yes | String | PO_20260624_01 | Original business order ID |
| Log Date | logDate | No | String(10) | 2026-06-24 | Date the funds settled in the pool (null if unsettled) |
| Amount | settlementAmount | No | long | 50000 | Actual settlement amount in micro units |
| Node | currentNode | Yes | String | SETTLED | Current flow node: PENDING, UNSETTLED, APPLYING, SETTLED |
| Fee Nodes | feeNodes | No | List | Array of gateway fees, merchant fees, dispute fees (parsed from JSON) |
# feeNodes Data Structure
| Field Name | Variable | Required | Type | Example | Description |
|---|---|---|---|---|---|
| Fee Name | feeName | Yes | String | GatewayFee | Fee type, e.g., GatewayFee, MchFee, RefundFee |
| Amount | amount | Yes | long | 100 | Deducted or added amount in micro units |
| Currency | currency | Yes | String | USD | Billing currency |