用于指定支付流水退款,允许部分退,多次退。
微信+会员 线下接口支持部分退。
微信/会员+积分/券 不支持部分退
请求参数说明
| 参数 | 描述 | 必填 | 示例值 | 类型 | 最大长度 |
| action | 接口参数组 | 是 | object | ||
| └action | 需要调用的接口名称 | 是 | cash_refund | string | |
| get | GET参数组,本组参数需要参与签名 | 是 | object | ||
| └payid | 支付流水号 | 是 | 1827707173 | number | |
| └amt | 退款金额,不填默认全退 | 否 | 80 | number | |
| └op | 操作员 | 否 | 张三 | string |
请求示例
{
"action": {
"action": "cash_refund"
},
"get": {
"payid": "1827707173",
"amt": "80",
"op": "张三"
}
}响应参数说明
| 参数 | 描述 | 必填 | 示例值 | 类型 | 最大长度 |
| status | 返回状态。接口成功时为1,出错为0 | 是 | 1 | number | |
| type | 类型, wx=微信,ali=支付宝 | 是 | wx | string | |
| info | 错误时会返回相应的错误信息 | 是 | 成功退款 | string | |
| payid | 支付流水号 | 是 | 1827707173 | number | |
| state | 支付状态 | 否 | 3 | number | |
| refund_id | 退款流水id | 否 | 186260020000540141 | number | |
| balance | 余额 | 否 | 0.01 | number | |
| duration | 接口耗时 | 否 | 1126ms | string | |
| env | 服务器地址 | 否 | beta | string | |
| request_time | 服务器时间 | 否 | 10:35:25.482 | string | |
| msid | 门店编号 | 否 | 10021 | number |
响应示例
{
"status": "1",
"info": "退款成功",
"type": "wx",
"payid": "186260020000540139",
"state": 3,
"refund_id": "186260020000540141",
"balance": "0.01",
"server_timestamp": 1778034926,
"server_time": "2026-05-06 10:35:26",
"server_name": "nx-203.hz",
"duration": "1126ms",
"env": "beta",
"request_time": "10:35:25.482",
"msid": "10021"
}