10.1 查询商户订单接口

#简要描述： 该接口用于查询商户的支付订单，根据商户id和订单号能够查看和管理其支付记录。

• 请求方式: POST
• 请求接口: https://网关域名/wallet-trade-merchant/payment/payment/by-third
• 请求媒体类型( JSON 数据格式 )Content-Type: application/json

查询参数

参数名称	类型	必填	参数含义	参数说明
orderId	string	否	钱包订单号	钱包订单号(商户本地订单号2选1)
localOrderId	string	否	本地订单号	商户本地订单号(钱包订单号2选1)
merchantId	string	否	商户ID
key	string	是	商户key
sign	string	是	签名	详情见签名算法

请求json样例

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

返回值

参数名称	类型	参数含义	参数说明
code	int32	请求状态	返回代码，0为业务成功，否则代表不同的错误
success	boolean	成功状态	成功标识，与code=0一致，用于兼容历史
message	string	描述	错误消息。如果有错误时，返回的错误消息
data	json	返回数据。	参数详见下面说明

返回示例

{
   "code": 0,
   "success": true,
   "message": null,
   "data": {
        "merchantId": 302992856974,
        "merchantUserId": null,
        "orderId": "274224939517780",
        "localOrderId": "conantest212",
        "type": "PAYMENT",
        "status": "SUCCESS",
        "bizType": "PAYMENT_ANY_DIGITAL_SCAN",
        "currency": "USDT",
        "amount": 5,
        "merchantCurrency": "USDT",
        "merchantPaidAmount": 5,
        "merchantActualAmount": 2.9,
        "userCurrency": "USDT",
        "userAmount": 5,
        "notifyTime": 1743056632190,
        "extra": null,
        "blockchain": {
                  "network": "TRON",
      "txId":"18b296c590f79e1db78b774f5ff02008a0edb0fd8f853d1eaf52071c73e0438e",
                  "senderAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
                  "receiverAddress": "TA1jptT16DssYWVGdVyFWxonku6hWK7En3"
                      },
        "orderCreateTime": 1743056388295,
        "blockchainInfo": {
                   "id": 678,
     "txid": "18b296c590f79e1db78b774f5ff02008a0edb0fd8f853d1eaf52071c73e0438e",
                   "network": "TRON",
                   "blockNum": 55604191,
                   "coin": "USDT",
                   "amount": 5,
                   "collectAddress": "TA1jptT16DssYWVGdVyFWxonku6hWK7En3",
                   "sendAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
                   "orderId": 274224939517780
                           },
                  "tradeNetwork": "TRON",
                  "tradeAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS"
            }
}

data参数说明

参数名称	类型	参数含义	备注
orderId	string	订单号
merchantId	int64	商户ID
merchantUserId	string	商户用户ID(商户不传则为NULL)
localOrderId	string	订单号
status	enum	订单状态	PROCESSING:处理中| SUCCESS:已完成|FAIL:已失败
type	enum	订单类型	PAYMENT:支付订单 | WITHDRAW:提款订单
bizType	enum	bizType类型说明如下
currency	string	订单币种
amount	string	订单金额
merchantCurrency	string	商户收款币种
merchantPaidAmount	number	商户应收或应付金额
userCurrency	string	用户支付或提款币种
userAmount	number	用户支付或提款金额
merchantActualAmount	number	商户实收或实付金额
notifyTime	int64	通知时间戳
orderCreateTime	int64	订单创建时间戳
blockchainInfo	object	链信息
└ id	int64	内部ID
└ txid	string	交易ID
└ network	string	主网
└ blockNum	int64	区块高度
└ coin	string	币种
└ amount	number	金额
└ collectAddress	string	接收地址
└ sendAddress	string	发送地址
└ orderId	int64	订单号
blockchain	object	链交易信息
└ network	string	主网
└ txid	string	交易ID
└senderAddress	string	发送地址
└receiverAddress	string	收款地址

bizType类型说明：

1、PAYMENT_WALLET_SCAN MINPAY钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至MINPAY钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付