Appearance
退款订单查询
公共参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例 |
|---|---|---|---|---|---|
| mch_no | String | 是 | 32 | 商户号 | 2014072300007148 |
| method | String | 是 | 128 | 接口名称 | trade.pay.refund.query |
| charset | String | 是 | 10 | 调用的接口版本,固定为:utf-8 | utf-8 |
| sign_type | String | 是 | 10 | 商户生成签名字符串所使用的签名算法类型,目前支持 RSA | RSA |
| sign | String | 是 | 344 | 商户请求参数的签名串 | 详见示例 |
| timestamp | String | 是 | 19 | 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" | 2014-07-24 03:07:50 |
| version | String | 是 | 3 | 调用的接口版本,固定为:1.0 | 1.0 |
| notify_url | String | 否 | 256 | 异步通知地址 | |
| return_url | String | 否 | 256 | 同步跳转地址 | |
| biz_content | String | 是 | 业务参数 |
业务参数
| 参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例 |
|---|---|---|---|---|---|
| out_trade_no | String | 二选一 | 64 | 商户订单号。由商家自定义,需保证在商户端不重复。 | 20150320010101001 |
| trade_no | String | 二选一 | 64 | 平台商订单号 | 20150320010101001 |
| out_trade_refund_no | String | 是 | 64 | 商户退款订单号 | 2015032001010100101 |
返回信息
json
返回结果示例:
{
"code": 20000,
"msg": "success",
"out_trade_no": "1977641770112053316",
"refund_amount": "77.71",
"refund_status": "REFUND_SUCCESS",
"trade_no": 836266688496631808,
"succeed_at": 1760342272,
"sign": "Qp2GW+xbOeqc4PtBrjfHZCwo0hvuKPrytuk5I/cjONARNdj05B9JaeLqjfReULsjGHjilkxxjnFXykUAxFwKFlPy+BrCNByo0Zxq38YR7tA5iAMITmYHcxxFPYRWoK0IH6i/wdzkyGP6lfQQFQg5VXuH96M4JjENLijBvSgtsB1qInaiAuNKtfe7HXtayvP//UbaLwqfFzvJWvhPXIF3ememrpzlTbplDuhPWyD6WWlplH93aMNAPJ7xPV2JtrM+M0mnMVU5fhLOJTJZaPi5As0+1n8MDb07EAf+y/Br8E9KZrdkhMSqYJ/2A3IeesJ/NUFAERArS6lEGekY+sF1Uw=="
}返回字段说明
| 参数 | 类型 | 描述 |
|---|---|---|
| code | Int | 20000 |
| msg | String | success |
| out_trade_no | String | 商户支付订单号 |
| refund_amount | String | 退款金额,单位元 |
| refund_status | String | 退款状态(参照返回状态说明) |
| trade_no | String | 鸿闻支付订单号 |
| succeed_at | Number | 退款成功时间 |
| sign | String | 签名字符串 |
返回状态说明
| 名称 | 描述 |
|---|---|
| REFUND_PROCESS | 退款中 |
| REFUND_SUCCESS | 退款成功 |
| REFUND_FAIL | 退款失败 |
| REFUND_CANCEL | 退款取消 |
| TRADE_REFUND | 已退款 |
| REFUND_SUSPEND | 退款中断 |
| REFUND_DEFAULT | 默认状态(无任何意义) |
