API REFERENCE

巴西 · 查询代收订单

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

接口地址#

POSThttps://YOUR_GATEWAY_HOST/Pay_Trade_query.html

application/x-www-form-urlencoded

参数定义#

字段	要求	参与签名	说明
`pay_memberid`	必填	是	面板显示的商户号，不是内部用户 ID。
`pay_orderid`	必填	是	商户原始代收订单号。查询时使用此值，不要使用创建响应中的平台订单号。
`pay_md5sign`	必填	否	32 位大写 MD5 签名；此字段本身不参与计算。

字段	说明
`memberid`	面板显示的商户号，不是内部用户 ID。
`orderid`	商户原始订单号。
`amount`	BRL 金额，响应可能为 JSON 数字或字符串，不保证固定小数格式；验签时保留收到的原始值。
`true_amount`	记录的实际支付金额；历史数据或未采集的数据可能为空或为零。
`time_end`	成功支付完成时间：yyyy-MM-dd HH:mm:ss；未支付订单的该字段不代表已完成。
`transaction_id`	平台订单号或交易流水号。
`returncode`	正常查询固定为 "00"，实际支付状态以 trade_state 为准。
`trade_state`	NOTPAY：未支付；SUCCESS：支付完成。
`sign`	32 位大写 MD5 签名；此字段本身不参与计算。

请求与响应示例#

cURL · 使用前替换占位参数

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

请求参数 · 以表单提交

{
  "pay_memberid": "10000",
  "pay_orderid": "DEMO_PAYIN_001",
  "pay_md5sign": "CALCULATE_WITH_YOUR_APIKEY"
}

响应示例

{
  "memberid": "10000",
  "orderid": "DEMO_PAYIN_001",
  "amount": "100.00",
  "true_amount": "100.00",
  "time_end": "2026-10-24 12:00:00",
  "transaction_id": "DEMO_PLATFORM_PAYIN",
  "returncode": "00",
  "trade_state": "SUCCESS",
  "sign": "CALCULATE_WITH_YOUR_APIKEY"
}

响应示例

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

签名与结果处理#

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

查看签名指南