跳转到内容

代付回调

请求头

回调请求头。

请求参数

字段类型必填最大长度说明
merchantOrderNoString是32商户订单号
tradeNoString是32平台单号
payoutAmountString是-付款金额,整数或保留 2 位小数
payoutTypeString是24代付方式
payoutStatusString是20订单状态
failMsgString否200订单失败原因
serviceAmountString否-服务费用
completeTimeString是-完成时间(国家当地时间,格式 yyyy-MM-dd HH:mm:ss)
refundNoString否32退款单号;仅巴西代付退款通知返回
refundAmountString否-退款金额;仅巴西代付退款通知返回
refundTimeString否-退款时间;仅巴西代付退款通知返回,格式 yyyy-MM-dd HH:mm:ss

请求示例

{
"merchantOrderNo": "PAYOUT202609170001",
"tradeNo": "VF2405220001BR0000508467743993",
"payoutAmount": "100.00",
"payoutType": "CPF",
"payoutStatus": "REFUND",
"serviceAmount": "1.00",
"completeTime": "2026-09-17 15:30:00",
"refundNo": "REFUND202609170001",
"refundAmount": "100.00",
"refundTime": "2026-09-17 16:00:00"
}

响应参数

字段类型必填示例值说明
resultString是SUCCESS返回 SUCCESS 表示已成功接收;其他值按失败处理
msgString否OK处理结果说明

响应示例

{
"result": "SUCCESS",
"msg": "OK"
}
只有巴西代付回调包含退款相关字段;其他国家不会返回 refundNo、refundAmount 或 refundTime。