# 2. 查询代付状态接口
# 简要描述
- 商户代付-查询接口
# HTTP请求信息
# 请求URL
{domain}/open-api/disbursement/check
# 请求方式
- POST
# 请求头
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
Content-Type | mandatory | 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
}