跳转到内容

代收回调

该回调由 VellPay 主动发送至创建订单时传入或商户后台配置的代收回调地址,不需要调用 VellPay API。

请求头

回调请求头。

请求参数

字段类型必填最大长度说明
merchantOrderNoString是32商户订单号
tradeNoString是32平台单号
paymentSingleOrderNoString是32单次支付流水号
paymentAmountString是-实际收款金额,整数或保留 2 位小数
paymentTypeString是24支付方式
paymentStatusString是24订单状态
failMsgString否200订单失败原因
paymentInfoString否200支付信息
serviceAmountString否-服务费用
completeTimeString是-完成时间(国家当地时间,格式 yyyy-MM-dd HH:mm:ss)

请求示例

{
"merchantOrderNo": "ORDER202609170001",
"tradeNo": "VS2608270002KH0000000000040059",
"paymentSingleOrderNo": "PS20260917000001",
"paymentAmount": "100.00",
"paymentType": "KHQR",
"paymentStatus": "SUCCESS",
"serviceAmount": "1.00",
"completeTime": "2026-09-17 15:30:00"
}

响应参数

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

响应示例

{
"result": "SUCCESS",
"msg": "OK"
}