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": "weOfDMRpUAvAeOs5",
"orderId": 1,
"sign": "123"
}
返回值
| 参数名称 | 类型 | 参数含义 | 参数说明 |
| code | int32 | 请求状态 | 返回代码，0为业务成功，否则代表不同的错误 |
| success | boolean | 成功状态 | 成功标识，与code=0一致，用于兼容历史 |
| message | string | 描述 | 错误消息。如果有错误时，返回的错误消息 |
| data | json | 返回数据。 | 参数详见下面说明 |
返回示例
{
"code": 0,
"success": true,
"message": null,
"data": {
"merchantId": 303130673067,
"merchantUserId": "303130673067",
"orderId": "273125121521538",
"localOrderId": "2024111800661791498",
"type": "PAYMENT",
"status": "SUCCESS",
"bizType": "PAYMENT_ANY_DIGITAL_SCAN",
"currency": "CNY",
"amount": 100.46,
"merchantCurrency": "USDT",
"merchantPaidAmount": 14.27,
"merchantActualAmount": 14.27,
"userCurrency": "USDT",
"userAmount": 14.27,
"notifyTime": 1732020951085,
"orderCreateTime": 1731937459078,
"blockchainInfo":null
}
}
data参数说明
| 参数名称 | 类型 | 参数含义 | 备注 |
|---|---|---|---|
| orderId | int64 | 订单号 | |
| merchantId | int64 | 商户ID | |
| merchantUserId | string | 商户用户ID(商户不传则为NULL) | |
| localOrderId | string | 订单号 | |
| status | enum | 订单状态 | PROCESSING:处理中| SUCCESS:已完成|FAIL:已失败 |
| type | enum | 订单类型 | PAYMENT:支付订单 | WITHDRAW:提款订单 |
| bizType | enum | bizType类型说明如下 | PAYMENT_WALLET_SCAN |
| 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 | 订单号 |
bizType类型说明：
1、PAYMENT_WALLET_SCAN 点付钱包扫码支付
2、PAYMENT_TRANSFER 数字币绑定地址直充
3、PAYMENT_ANY_DIGITAL_SCAN 数字币任意金额扫码支付
4、WITHDRAW_WALLET 提款至点付钱包
5、WITHDRAW_ANY_DIGITAL_WALLET 提款数字币至任意钱包
6、PAYMENT_FIXED_DIGITAL_SCAN 数字币限定金额扫码支付
7、BATCH_PAY 批量代付