QueryOrderList API

Testing Env

https://testpay.onlinepay.ai

POST

/v2/order/queryOrderList

V2 Order List Query endpoint. Uses V2 signing rules where signType is determined by the merchant's encryption config in the database.

Differences from V1

signType is NOT a request parameter — resolved from merchant DB config (encryption field)

version must be V2.0.0

All parameters participate in signing (sorted alphabetically), including dateLimit, merOrderNos, tradeNos, etc.

Response includes sign and signType fields

Response signing content is the original request parameters

Query Conditions

At least one of dateLimit, merOrderNos, or tradeNos must be provided.

Request

Body Params application/json

Example

{
    "merNo": 111111,
    "merOrderNos": [
        "2222221",
        "2222222"
    ],
    "tradeNos": [
        "ONL02507071850393774"
    ],
    "dateLimit": {
        "from": "2026-04-01 00:00:00",
        "to": "2026-05-11 23:59:59"
    },
    "pageNum": 1,
    "pageSize": 10,
    "sign": "4B18D0A324F0D006A84A495940857395"
}

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location 'https://testpay.onlinepay.ai/v2/order/queryOrderList' \
--header 'Content-Type: application/json' \
--data '{
    "merNo": 111111,
    "merOrderNos": [
        "2222221",
        "2222222"
    ],
    "tradeNos": [
        "ONL02507071850393774"
    ],
    "dateLimit": {
        "from": "2026-04-01 00:00:00",
        "to": "2026-05-11 23:59:59"
    },
    "pageNum": 1,
    "pageSize": 10,
    "sign": "4B18D0A324F0D006A84A495940857395"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "code": "00000",
    "message": "Success",
    "data": {
        "pageNum": 1,
        "pageSize": 10,
        "totalPage": 2,
        "total": 15,
        "list": [
            {
                "state": 5,
                "merOrderNo": "20260501001",
                "tradeNo": "ONL02605011050393774",
                "handlingFee": "10.00",
                "receiveAmount": "100.00",
                "settlementCurrency": "USD",
                "settleAmount": "90.00",
                "rollingReserve": "5.00",
                "rollingReserveStatus": 0,
                "refusalPayReason": "",
                "message": "Transaction successful",
                "transactionFixedFee": "2.00",
                "exceptionHandlingFee": "0.00",
                "refundAmount": "0.00",
                "refundCurrency": "USD",
                "sourceAmount": "100.00",
                "sourceCurrency": "USD",
                "settle": 1
            }
        ]
    },
    "sign": "A1B2C3D4E5F6..."
}

Modified at 2026-05-27 09:25:35

Query Order API

QueryBalance API