# 2、Query Orders
Request Method
- POST
Request URL
/api/v3/qr/query/collectingOrder
Request Header
Header: { "Content-Type": "application/json; charset=utf-8" }
Request Header Parameters
| Param | Type | Description | Sample |
|---|---|---|---|
| access_key | String | Merchant's backend access key | pFqV75X3 |
| timestamp | String | 13-digit Unix timestamp in milliseconds | 1679724896223 |
| nonce | String | UUID v4 random string | 794c26b0-d33c-4394-b2bb-c485eca16d9e |
| sign | String | Signature generated using the secret_key | kAXyh+eerqrefyaF8dyFB0M4FVo= |
Request Example
{
"externalOrderId": "389508808434869257",
"orderId": "OCURRPAID202307270301551690426915467DOCKER020000000400000744",
}
Request Parameters Description
| Param | Type | Required | Description |
|---|---|---|---|
| externalOrderId | String | Optional | Merchant Order ID |
| orderId | String | Optional | System Order ID |
Response Header
Header: { "Content-Type": "application/json; charset=utf-8" }
Response Example
{
"code":"200",
"success":true,
"msg":"成功",
"msgEn":"SUCCESS",
"data":[
{
"orderId":"OCURRPAID202504290319221745896762586HAMBIT-U0000000401297557",
"cashierId":"OCURRPAID202504290319221745896762530HAMBIT-U0000000201297556",
"orderType":1,
"orderResourceType":2,
"userId":"1892907051323297793",
"orderStatus":2,
"orderTime":1745896763000,
"channelOrderId":"OQRCODE20250429031922noDE0YTRxhABi",
"externalOrderId":"20250429111919543127",
"orderAmount":"10.11",
"orderActualAmount":"10.11",
"orderFee":"3.405",
"orderPayTime":1745896811000,
"orderCompleteTime":1745896811000,
"currencyType":"INR",
"payType":127,
"tradeNote":"",
"notifyUrl":"https://test/testNotifySuccess",
"markStatus":0,
"errorMsg":null,
"errorMsgEn":null,
"accountType":"",
"accountName":"",
"accountNo":"",
"userInfoName":"",
"userInfoNo":"",
"businessId":"1745896762599wlkr9bjcb2je4yvgdcz",
"orderTypeCode":"Pay",
"orderResourceTypeCode":"Currency",
"orderStatusCode":"Payment success",
"payTypeCode":""
}
]
}
Response Parameter Description
| Parameter Name | Type | Description |
|---|---|---|
| bankOrderId | String | Bank order number |
| accountName | String | Account name |
| orderActualAmount | String | Actual order amount. The amount actually paid by the consumer, which may differ from the order amount at creation; the actual payment by the consumer is the correct value. |
| orderAmount | String | Original order amount. The amount initiated when the order was created. |
| orderFee | String | Order fee. Calculated based on the actual order amount (orderActualAmount). |
| orderPayTime | int64 | Order payment time (Unix timestamp in milliseconds) |
| orderCompleteTime | int64 | Order completion time (Unix timestamp in milliseconds) |
| errorMsg | String | Error message (in Chinese) |
| errorMsgEn | String | Error message (in English) |
| accountNo | String | Account number |
| accountType | String | Account type |
| cashierId | String | Cashier ID |
| channelOrderId | String | Associated channel order number |
| currencyType | String | Fiat currency type code, enumeration value: BRL INR |
| externalOrderId | String | Merchant order number |
| notifyUrl | String | Callback URL after payment completion |
| orderId | String | System-generated order number |
| orderResourceType | int64 | Business type of the order, enumeration value: 2 (Fiat order) |
| orderStatus | int64 | Order status, enumeration values: 1, 2 (1 - Pending Payment, 2 - Payment Successful (Final State)) |
| orderTime | int64 | Order creation time (Unix timestamp in milliseconds) |
| orderType | int64 | Order type, enumeration values: 1, 2 (1 - Collection, 2 - Payout) |
| payType | int64 | Payment method type code, |
| tradeNote | String | Merchant note information |
| userId | String | User ID |
| payTypeCode | String | Description of payType, |
| orderStatusCode | String | Description of orderStatus, enumeration values: Wait pay, Payment Successful |
| orderTypeCode | String | Description of orderType, enumeration values: Collection, Payout |
| userInfoName | String | User's name |
| userInfoNo | String | User's identification number |
| businessId | String | Merchant business ID |