ORDER
03
申请退款 / 退款查询
V2 申请退款
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 商户 ID | pid | 是 | Int | |
| 退款订单号 | out_refund_no | 是 | String | 商户系统退款单号 |
| 平台订单号 | trade_no | 是 | String | 原支付订单号 |
| 退款金额 | money | 是 | String | 单位：元，不超过原订单金额 |
| 时间戳 | timestamp | 是 | String | |
| 签名 | sign | 是 | String | |
| 签名类型 | sign_type | 是 | String | RSA |
V2 退款查询
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 商户 ID | pid | 是 | Int | |
| 平台退款单号 | refund_no | 特殊必填 | String | 与 out_refund_no 必传其一 |
| 商户退款单号 | out_refund_no | 特殊必填 | String | 与 refund_no 必传其一 |
| 时间戳 | timestamp | 是 | String | 10 位整数，单位秒 |
| 签名 | sign | 是 | String | |
| 签名类型 | sign_type | 是 | String | RSA |
退款查询返回字段
| 字段名 | 变量名 | 类型 | 描述 |
|---|---|---|---|
| 返回状态码 | code | Int | 0 为成功，其它为失败 |
| 错误信息 | msg | String | 失败时返回提示 |
| 平台退款单号 | refund_no | String | |
| 商户退款单号 | out_refund_no | String | |
| 平台订单号 | trade_no | String | |
| 商户订单号 | out_trade_no | String | |
| 退款金额 | money | String | 单位：元 |
| 扣减商户余额 | reducemoney | String | |
| 退款状态 | status | Int | 0:失败, 1:成功 |
| 退款时间 | addtime | String | 如 2024-07-01 16:47:32 |
提示：申请退款返回
code=0 仅表示接口调用成功，退款最终结果以退款查询返回的 status=1 为准；失败时通过 msg 查看原因。
V1 申请退款
| 字段名 | 变量名 | 必填 | 描述 |
|---|---|---|---|
| 商户 ID | pid | 是 | |
| 商户密钥 | key | 是 | |
| 平台订单号 | trade_no | 特殊可选 | 与 out_trade_no 二选一 |
| 商户订单号 | out_trade_no | 特殊可选 | 都传以 trade_no 为准 |
| 退款金额 | money | 是 | 少数通道需与原金额一致 |
返回 code=0 表示退款成功，其它为失败。
注意：V1 退款需先在商户后台开启「订单退款 API」开关，才能调用该接口。