# 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 |