Batch query payment orders

Batch query payment orders by merchant outer order numbers or by time range. If outerOrderList is provided, beginTime/endTime are ignored. Time-based queries are limited to recent history (up to 30 days). Each item may include optional subMerchantCode when present on the original payment.

Header Parameters

X-R-Ts*string

request timestamp in milliseconds

X-R-Ak*string

merchant's appKey

X-R-Signature*string

request signature

X-R-Key-Version?string

merchant's private key version, default is 1

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

outerOrderSnList?array<>

A list of merchant outer order numbers to filter the query by. If provided, beginTime and endTime will be ignored. If not provided, beginTime and endTime are required.

beginTime?integer

The start time of the query range in milliseconds. Required if outerOrderList is not provided. Ignored when outerOrderList is provided. The maximum allowed range is 30 days; beginTime must be earlier than endTime.

endTime?integer

The end time of the query range in milliseconds. Required if outerOrderList is not provided. Ignored when outerOrderList is provided. The maximum allowed range is 30 days; endTime must be later than beginTime.

pageNo?integer

The page number for pagination. This field defines which page of results to retrieve. If not provided, default:1

pageSize?integer

The number of items per page to retrieve.If not provided, default: 10

Response Body

`/`

`application/json`

curl -X POST "https://example.com/openapi/v2/order/list" \  -H "X-R-Ts: 1762327084929" \  -H "X-R-Ak: string" \  -H "X-R-Signature: string" \  -H "Content-Type: application/json" \  -d '{}'

"open api common response"

{  "code": "paramFormatError",  "message": "request param invalid"}

{  "code": "authorizationInvalid",  "message": "authorizationInvalid invalid"}

{  "code": "notInWhiteList",  "message": "request ip not in the white list"}

{  "code": "frequencyLimited",  "message": "Too many requests, please try again later"}

Header Parameters

Request Body

Response Body

200*/*

400application/json

401application/json

403application/json

429application/json

`/`

`application/json`

`application/json`

`application/json`

`application/json`