# 2. 查询代付状态接口
# 简要描述
- 商户代付-查询接口
# 请求URL
{domain}/open-api/disbursement/check
# 请求方式
- POST
# 请求头
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Content-Type | 是 | string | application/json |
# 请求体参数
| 参数名 | 必选 | 类型 | 长度限制 | 示例 | 说明 |
|---|---|---|---|---|---|
| appId | 是 | string | - | - | 应用APPID |
| param | 是 | string | - | - | 参数体 |
| sign | 是 | string | - | 45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892 | 签名 |
# param 参数
| 参数名 | 必选 | 类型 | 长度限制 | 示例 | 说明 |
|---|---|---|---|---|---|
| mchOrderId | 是 | string | 1-32 | CCP20220428011068111 | 商户订单id,格式:字母+数字, 1-32位 |
| timestamp | 是 | long | - | 1678356680000 | 毫秒时间戳 |
# 请求体示例
{
"appId": "733b887a4a784708bb369524db5b6ded",
"sign": "Platform",
"param": "{\"mchOrderId\":\"MCHORDERIDC00001\",\"timestamp\":\"1677133173758\"}"
}
# 响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | integer | 响应码 |
| message | string | 响应信息 |
| data | Object | 数据 |
# data参数
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| mchOrderId | String | - | 商户订单号 |
| transactionId | String | D1656505190221611009 | Platform系统订单号,Platform系统唯一标识 |
| amount | long | 3000 | 交易金额,单位:分 |
| transactionStatus | String | 参考列表 | 交易状态 |
| createTime | String | 2023-05-04 11:43:08 | 交易创建时间 |
| returnTime | String | - | 交易完成时间 |
| remark | String | COMPLETED | 备注 |
| failedCode | String | 参考列表 | 交易错误码 |
| failedMessage | String | - | 交易错误信息 |
# 返回示例
# 响应参数
{
"code": 10000,
"message": "Success",
"data": {
"mchOrderId": "MCHORDERIDC00001",
"transactionId": "D1656505190221611008",
"amount": 3000,
"transactionStatus": "FAILED",
"createTime": "2023-05-04 11:43:08",
"returnTime": "2023-05-04 11:43:47",
"failedCode": -10004,
"failedMessage": "Transaction Channel Rejected"
}
}
# 失败返回示例
{
"code": 21010,
"message": "transaction not found",
"data": null
}