主题
商户代付查询
接口描述
- 商户可以通过查询订单接口主动查询代付订单状态，完成下一步的业务逻辑。
- 查询订单可通过支付订单号和商户订单号两种方式查询。
请求URL
/merchant/defray/queryDefrayRecord
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202409561403450909 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| outTradeNo | 否 | string | 32 | 接入方交易流水号(与defrayNo不可同时为空) | OUT00000001 |
| defrayNo | 否 | string | 32 | 支付系统代付流水号(与outTradeNo不可同时为空) | 1854100814175592449 |
- 注：outTradeNo与defrayNo不能同时为空
请求报文示例
json
{
"appId": "202415629590370906",
"outTradeNo": "18511110003547765",
"signature": "DyvGpiKpOXZSGMhn0xdYVaCTzRmJf5XPIURn9Rsou6bHWODwFYAEb8QOACgt1gQlEUqmZYuyTXwxj7froBZ60U7X3Cn337LTjkU5eHQW3RInlc0FbA/7FzIBeLrpeHlqXo76N7wm6kPH2zcBMwCVECR86zzwyxs6wP83JFDl2mTQTMOJFgPZGN5ALOeVgw5tNTMHg7qYMe0BsyHJe1QE8MRToPXTWwS/Lh93kbOM+k/r2iJbI6n3zO35+LsDKcrpT1m6BMGkDQYy/VnnKHm/AVp/Vh7csqlQ5SefcOJfP82nmf2PHtSVNO6H7i8RH5UT1UAfo7PhSSuxdk/V0yANAg==",
"transDate": "1731469813663",
"transNonce": "967f5385-6b7d-43b3-8019-9883f7075b2d"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| outTradeNo | 是 | string | 32 | 接入方交易流水号 | OUT00000001 |
| defrayNo | 是 | string | 32 | 支付系统交易流水号 | 1854100814175592449 |
| merchantNo | 是 | string | 32 | 商户号 | XS240820000054 |
| tradeAmount | 是 | string | 20 | 交易金额(单位分) | 100 |
| tradeFee | 是 | string | 20 | 交易手续费(单位分) | 1 |
| tradeStatus | 是 | string | 32 | 交易状态： 初始：INIT 处理中：PROCESSING 成功： SUCCESS 失败：FAIL | PAYING |
| payFinishTime | 否 | string | 32 | 交易完成时间(yyyyMMddHHmmss) | 202411110858 |
| failReason | 否 | string | 32 | 失败原因 | 错误信息 |
响应示例
json
{
"code": "00000000",
"merchantNo": "XS241026000093",
"message": "成功",
"outTradeNo": "18511110003547765",
"payFinishTime": "20241113114701",
"tradeAmount": "1",
"tradeFee": "0",
"defrayNo": "1856544267009564674",
"tradeStatus": "INIT",
"tradeSubject": "JMETERTEST",
"transDate": "1731469813663",
"transNonce": "967f5385-6b7d-43b3-8019-9883f7075b2d",
"failReason": "失败原因",
"signature": "DyvGpiKpOXZSGMhn0xdYVaCTzRmJf5XPIURn9Rsou6bHWODwFYAEb8QOACgt1gQlEUqmZYuyTXwxj7froBZ60U7X3Cn337LTjkU5eHQW3RInlc0FbA/7FzIBeLrpeHlqXo76N7wm6kPH2zcBMwCVECR86zzwyxs6wP83JFDl2mTQTMOJFgPZGN5ALOeVgw5tNTMHg7qYMe0BsyHJe1QE8MRToPXTWwS/Lh93kbOM+k/r2iJbI6n3zO35+LsDKcrpT1m6BMGkDQYy/VnnKHm/AVp/Vh7csqlQ5SefcOJfP82nmf2PHtSVNO6H7i8RH5UT1UAfo7PhSSuxdk/V0yANAg=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述