10.2 Query merchant’s fiat currency orders (OTC payment)

#Brief description: This interface is used to query the merchant's legal currency payment orders (OTC payment), and the order details can be viewed according to the order number.

• Request method: POST
• Request interface: https://gateway-domain/wallet-trade-merchant/v1/otc/payment/by-third
• Request media type (JSON data format)Content-Type: application/json

Query parameters

Parameter name	Type	Required	Parameter meaning	Parameter description
orderId	string	No	Platform order number	Choose 1 from our platform order number or merchant’s local order number
localOrderId	string	No	Merchant’s local order number	Choose 1 of 2 merchant’s local order number or our platform’s order number
key	string	Yes	Merchant key	apiKey
sign	string	Yes	Signature	See Signature Algorithm for details

Request json sample

{  
  "key": "9yUreYgTRtit39Dy",
  "orderId": 274224939517780,
  "sign": "07792d2cf97811d3f2e7bd98edb477e3"
}

Return value

Parameter name	Type	Parameter meaning	Parameter description
code	int32	Request status	Return code, 0 means the business is successful, otherwise it represents a different error
success	boolean	Success status	Success identification, consistent with code=0, used for compatibility history
message	string	Description	Error message. If there is an error, the error message returned
data	json	Return data	See the parameters below for details

Return to Example

{
   "code": 0,
   "success": true,
   "message": null,
   "data": {
             "merchantId": 302992856974,
             "merchantUserId": null,
             "orderId": "456290286215493",
             "localOrderId": "D19C27AEC95C00297881P",
             "status": "SUCCESS",
             "currency": "CNY",
             "amount": "95",
             "notifyTime": 1770192373305,
             "orderCreateTime": 1770192298091
            }
}

data parameter description

Parameter name	Type	Parameter meaning	Parameter description
orderId	string	Order number
merchantId	int64	Merchant ID
merchantUserId	string	Merchant user ID (null if not passed by the merchant)
localOrderId	string	Order number
status	enum	Order Status	PROCESSING:处理中| SUCCESS:已完成|FAIL:已失败
currency	string	Order currency
amount	string	Order amount
orderCreateTime	int64	Order creation timestamp