API REFERENCE

巴西 · 查询代付订单

巴西查询代付订单的接口地址、参数与示例。

接口地址#

POSThttps://YOUR_GATEWAY_HOST/Payment_Dfpay_query.html

application/x-www-form-urlencoded

参数定义#

字段	要求	参与签名	说明
`mchid`	必填	是	面板显示的商户号，不是内部用户 ID。
`out_trade_no`	必填	是	商户原始代付订单号，每次新申请使用唯一订单号。
`pay_md5sign`	必填	否	32 位大写 MD5 签名；此字段本身不参与计算。

字段	说明
`status`	接口处理结果，不代表订单最终资金结果。
`msg`	接口消息。
`mchid`	面板显示的商户号，不是内部用户 ID。
`out_trade_no`	商户原始订单号。
`amount`	BRL 金额字符串，保留两位小数；限额和费率以商户及产品配置为准。
`transaction_id`	平台订单号或交易流水号。
`refCode`	业务状态码，参见状态表。
`refMsg`	状态说明，与 refCode 一起判断。
`success_time`	仅在已完成订单返回，使用巴西时间 yyyy-MM-dd HH:mm:ss。
`sign`	32 位大写 MD5 签名；此字段本身不参与计算。

状态值	说明
`"0"`	待审核、待处理或处理中，不是最终结果。
`"1"`	付款完成，包含 success_time。
`"2"`	审核驳回、失败或失败待驳回；此状态本身不能确认退款已到账。
`"7"`	交易不存在：status="error"，不含 sign。
`"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": "100.00",
  "transaction_id": "DEMO_PLATFORM_PAYOUT",
  "refCode": "1",
  "refMsg": "成功",
  "success_time": "2026-10-24 12:00:00",
  "sign": "CALCULATE_WITH_YOUR_APIKEY"
}

响应示例

{
  "status": "error",
  "msg": "请求成功",
  "refCode": "7",
  "refMsg": "交易不存在"
}

签名与结果处理#

按该接口的签名范围计算，不要把所有示例字段都加入签名。

查看签名指南