10.1 查询商户数字币订单（代收、代付）

#简要描述： 该接口用于查询商户的数字币代收、代付等订单，根据订单号能够查看其订单详情。

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

查询参数

参数名称	类型	必填	参数含义	参数说明
orderId	string	否	平台订单号	我方平台订单号或商户本地订单号2选1
localOrderId	string	否	商户本地订单号	商户本地订单号或我方平台订单号2选1
key	string	是	商户key	apiKey
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": "474882554749381",
        "localOrderId": "CONAN-TES1225668",
        "type": "PAYMENT",
        "status": "SUCCESS",
        "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
        "currency": "CNY",
        "amount": "75",
        "merchantCurrency": "CNY",
        "merchantPaidAmount": "75",
        "merchantActualAmount": "53.85",
        "userCurrency": "USDT",
        "userAmount": "11.19",
        "userReceivableAmount": "11.19",
        "userMinerFee": null,
        "rate": "6.70227804",
        "rateExpression": "1USDT≈6.7022CNY",
        "notifyTime": 1772461910628,
        "extra": null,
        "blockchain": {
             "network": "TRON",
             "txId":"403dd99b07cb2fd0a4a8ab3f99ef74c0
                     40700117a3429f393a74585ed3f23c09",
             "senderAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
             "receiverAddress": "TYZSzcYySHGQ1Kb1oC3GdEM1NiK95BvnX7"
                     },
         "walletUserId": null,
         "orderFailReason": null,
         "orderCreateTime": 1772461861907
            }
}

data参数说明

参数名称	类型	参数含义	参数说明
orderId	string	订单号
merchantId	int64	商户ID
merchantUserId	string	商户用户ID	返回下单参数 localUserId 的值，不传则为 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	订单创建时间戳
blockchain	object	链交易信息
└ network	string	主网
└ txid	string	交易ID
└senderAddress	string	发送地址
└receiverAddress	string	收款地址
userMinerFee	string	矿工费
userReceivableAmount	string	用户应收、应付金额
rate	string	汇率
rateExpression	string	汇率表达式
orderFailReason	string	订单失败原因
walletUserId	string	钱包内部用户ID
extra	json	自定义汇率信息	商户调用自定义汇率接口会返回此信息

bizType类型说明：

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