API REFERENCE

巴西 · 查询商户余额

巴西查询商户余额的接口地址、参数与示例。

接口地址#

POSThttps://YOUR_GATEWAY_HOST/Payment_Dfpay_querybalance.html

application/x-www-form-urlencoded

参数定义#

字段	要求	参与签名	说明
`mchid`	必填	是	面板显示的商户号，不是内部用户 ID。
`pay_md5sign`	必填	否	32 位大写 MD5 签名；此字段本身不参与计算。

字段	说明
`status`	接口处理结果，不代表订单最终资金结果。
`msg`	接口消息。
`balance`	查询时刻的商户余额快照，单位 BRL。

请求与响应示例#

cURL · 使用前替换占位参数

curl --request POST 'https://YOUR_GATEWAY_HOST/Payment_Dfpay_querybalance.html' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'mchid=10000' \
  --data-urlencode 'pay_md5sign=CALCULATE_WITH_YOUR_APIKEY'

请求参数 · 以表单提交

{
  "mchid": "10000",
  "pay_md5sign": "CALCULATE_WITH_YOUR_APIKEY"
}

响应示例

{
  "status": "success",
  "msg": "查询成功",
  "balance": "100.00"
}

响应示例

{
  "status": "error",
  "msg": "签名验证失败",
  "data": []
}

签名与结果处理#

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

查看签名指南