API REFERENCE

巴西 · 创建代收

巴西创建代收的接口地址、参数与示例。

接口地址#

POSThttps://YOUR_GATEWAY_HOST/Pay_Index.html

application/x-www-form-urlencoded

参数定义#

字段	要求	参与签名	说明
`pay_memberid`	必填	是	面板显示的商户号，不是内部用户 ID。
`pay_orderid`	必填	是	商户原始代收订单号。查询时使用此值，不要使用创建响应中的平台订单号。
`pay_amount`	必填	是	BRL 金额字符串，保留两位小数；限额和费率以商户及产品配置为准。
`pay_applydate`	必填	是	请求时间，建议使用巴西时间 yyyy-MM-dd HH:mm:ss；不要假定统一的签名有效期。
`pay_bankcode`	必填	是	分配的支付产品编码，须为该商户已启用的产品。
`pay_notifyurl`	适用时填写	非空时参与	商户异步通知地址，需要接收结果时填写。
`pay_callbackurl`	适用时填写	非空时参与	商户浏览器同步跳转地址，不需要同步跳转时可省略。
`pay_md5sign`	必填	否	32 位大写 MD5 签名；此字段本身不参与计算。
`type`	建议填写	否	API 创建订单建议使用 json，是否返回 JSON 取决于分配产品，需确认实际响应格式。
`pay_attach`	选填	否	附加数据，在代收结果中以 attach 返回，不参与签名；请求 JSON 输出应使用 type。
`pay_productname`	选填	否	商品名称，具体用途由分配产品决定。

字段	说明
`status`	接口处理结果，不代表订单最终资金结果。
`msg`	接口消息。
`pay_amount`	BRL 金额，响应可能为 JSON 数字或字符串，不保证固定小数格式；验签时保留收到的原始值。
`pay_orderid`	平台订单号或交易流水号。
`payUrl`	收银台地址，不是已完成支付的凭证。
`qrCode`	产品返回的 QR 内容，可能是 PIX 文本、Base64 或其他数据；不保证为图片 URL 或统一的 PIX 复制码，接入时确认格式。

请求与响应示例#

cURL · 使用前替换占位参数

curl --request POST 'https://YOUR_GATEWAY_HOST/Pay_Index.html' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'pay_memberid=10000' \
  --data-urlencode 'pay_orderid=DEMO_PAYIN_001' \
  --data-urlencode 'pay_amount=100.00' \
  --data-urlencode 'pay_applydate=2026-10-24 12:00:00' \
  --data-urlencode 'pay_bankcode=YOUR_PRODUCT_CODE' \
  --data-urlencode 'pay_notifyurl=https://example.com/payin/notify' \
  --data-urlencode 'pay_callbackurl=https://example.com/payin/return' \
  --data-urlencode 'type=json' \
  --data-urlencode 'pay_md5sign=CALCULATE_WITH_YOUR_APIKEY'

请求参数 · 以表单提交

{
  "pay_memberid": "10000",
  "pay_orderid": "DEMO_PAYIN_001",
  "pay_amount": "100.00",
  "pay_applydate": "2026-10-24 12:00:00",
  "pay_bankcode": "YOUR_PRODUCT_CODE",
  "pay_notifyurl": "https://example.com/payin/notify",
  "pay_callbackurl": "https://example.com/payin/return",
  "type": "json",
  "pay_md5sign": "CALCULATE_WITH_YOUR_APIKEY"
}

响应示例

{
  "status": "1",
  "msg": "下单成功",
  "pay_amount": 100.0,
  "pay_orderid": "DEMO_PLATFORM_PAYIN",
  "payUrl": "https://example.com/cashier/DEMO",
  "qrCode": "PRODUCT_SPECIFIC_QR_CONTENT"
}

响应示例

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

签名与结果处理#

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

查看签名指南