接口地址#
POST
https://YOUR_GATEWAY_HOST/Payment_Dfpay_query.htmlapplication/x-www-form-urlencoded
参数定义#
| 参数名称 | 参数含义 | 是否参与签名 | 参数说明 |
|---|---|---|---|
out_trade_no | 商户代付订单号 | 是 | 订单号唯一 |
mchid | 商户号 | 是 | 平台分配商户号 |
pay_md5sign | MD5数据签名 | 否 | 请看MD5签名处理 |
| 参数名称 | 参数含义 | 是否参与签名 | 参数说明 |
|---|---|---|---|
status | 提现状态 | 是 | success：请求成功,不代表业务成功error：请求失败 |
msg | 状态描述 | 是 | 代付结果描述 |
mchid | 商户号 | 是 | status=success 返回 |
out_trade_no | 商户代付订单号 | 是 | status=success 返回 |
amount | 代付金额 | 是 | status=success 返回 |
transaction_id | 平台订单号 | 是 | status=success 返回 |
refCode | 业务状态 | 是 | status=success 返回refCode 1:成功 2:失败 |
refMsg | 业务描述 | 是 | status=success 返回 |
success_time | 代付成功时间 | 是 | status=success，refCode=1成功时返回 |
sign | MD5数据签名 | 否 | 请看MD5签名处理 |
| refCode | refMsg |
|---|---|
1 | 成功 |
2 | 失败 / 失败,请驳回 |
3 | 处理中 |
4 | 待处理 |
5 | 审核驳回 |
6 | 待审核 |
7 | 交易不存在 |
8 | 未知状态 |
请求与响应示例#
cURL · 使用前替换占位参数
curl --request POST 'https://YOUR_GATEWAY_HOST/Payment_Dfpay_query.html' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'mchid=10000' \
--data-urlencode 'out_trade_no=DEMO_PAYOUT_001' \
--data-urlencode 'pay_md5sign=CALCULATE_WITH_YOUR_APIKEY'请求参数 · 以表单提交
{
"mchid": "10000",
"out_trade_no": "DEMO_PAYOUT_001",
"pay_md5sign": "CALCULATE_WITH_YOUR_APIKEY"
}响应示例
{
"status": "success",
"msg": "请求成功",
"mchid": "10000",
"out_trade_no": "DEMO_PAYOUT_001",
"amount": "100000.00",
"transaction_id": "DEMO_PLATFORM_PAYOUT",
"refCode": "1",
"refMsg": "成功",
"success_time": "2026-10-11 12:05:00",
"sign": "CALCULATE_WITH_YOUR_APIKEY"
}响应示例
{
"status": "success",
"msg": "请求成功",
"mchid": "10000",
"out_trade_no": "DEMO_PAYOUT_001",
"amount": "100000.00",
"transaction_id": "DEMO_PLATFORM_PAYOUT",
"refCode": "3",
"refMsg": "处理中",
"sign": "CALCULATE_WITH_YOUR_APIKEY"
}响应示例
{
"status": "error",
"msg": "请求成功",
"refCode": "7",
"refMsg": "交易不存在"
}签名与结果处理#
按该接口的签名范围计算，不要把所有示例字段都加入签名。
查看签名指南