# 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