API REFERENCE

巴西 · 代收异步通知

巴西代收异步通知的接口地址、参数与示例。

通知目标#

POSTpay_notifyurl

application/x-www-form-urlencoded

参数定义#

字段	要求	参与签名	说明
`memberid`	必填	是	面板显示的商户号，不是内部用户 ID。
`orderid`	必填	是	商户原始订单号。
`transaction_id`	必填	是	平台订单号或交易流水号。
`amount`	必填	是	请求的 BRL 本金，不含手续费；用收到的原始金额验签。
`datetime`	必填	是	通知生成时间：yyyyMMddHHmmss，例如 20261024120000。
`returncode`	必填	是	代收成功为字符串 "00"。
`sign`	必填	否	32 位大写 MD5 签名；此字段本身不参与计算。
`attach`	选填	否	附加数据，在代收结果中以 attach 返回，不参与签名；请求 JSON 输出应使用 type。

请求与响应示例#

通知示例

{
  "memberid": "10000",
  "orderid": "DEMO_PAYIN_001",
  "transaction_id": "DEMO_PLATFORM_PAYIN",
  "amount": "100.00",
  "datetime": "20261024120000",
  "returncode": "00",
  "sign": "CALCULATE_WITH_YOUR_APIKEY",
  "attach": "DEMO_ATTACH"
}

通知示例

HTTP/1.1 200 OK
Content-Type: text/plain; charset=UTF-8

OK

通知示例

fail

签名与结果处理#

处理前先验证 sign，再核对商户、订单与金额，并幂等更新。

查看签名指南

处理成功后的应答

OK