Appearance
直接退款
说明:当不需要退分账的情况,可以调用此接口直接退款。
公共参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
mch_no | String | 是 | 32 | 商户号 | 2014072300007148 |
method | String | 是 | 128 | 接口名称 | trade.apply.refund |
charset | String | 是 | 10 | 调用的接口版本,固定为:utf-8 | utf-8 |
sign_type | String | 是 | 10 | 商户生成签名字符串所使用的签名算法类型,目前支持 RSA | 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 | 平台(鸿闻)支付订单号 | 20150320010101002 |
out_trade_refund_no | String | 是 | 64 | 商户退款订单号,唯一 | 202329112001 |
refund_amount | String | 是 | 10 | 退款金额(元) | 9.98 |
refund_reason | String | 否 | 128 | 退款原因 | 申请退款的原因 |
返回信息
json
成功返回信息:
{
"code": 20000,
"msg": "success",
"mch_no": "21629082503094",
"trade_no": 571004898850897920,
"out_trade_no": "q1211231111",
"refund_trade_no": 570914020383764480,
"refund_out_trade_no": "21551125xx1xxxxxx1421",
"refund_status": "REFUND_SUCCESS",
"refund_amount": "0.01",
"succeed_time": 0,
"failed_time": 0,
"sign": "MFN4L4vyNYkFJvloI6jlecLrkLAZ+bisJomusFuvDpvVPpcnKggAVC2pfPMN0QPyJUIZRNs42KdwRc2+MbZQIvTaBXGoPErKQ5buHZSGqVw1OuOdmM7yT7mHOgfjuZl/dncfdzvg/nKC1SagPY+ejQRqTqQc2cok5pugg7LfPAnL6K7xTSMuVv6k05IGpqMBX+FDr23x3gEY4TT6kRJgvmBHJmOaiybzt/FxQ13YLjf2VqwAVebKaEhyFWvQc2vzcuQVLw1WnYlDh0SnPPCLv9f8Cm45a8DMwAK0yKf/sCjdi+yWltTTHDsE0WYb3HWskGPg6xBdCX6FzePZqPZR+w=="
}
失败返回信息:
{
"code": 50000,
"msg": "申请退款失败",
"mch_no": "21629082503094",
"trade_no": 570913639062810625, // 鸿闻支付订单号
"out_trade_no": "q12111111", // 商户支付订单号
"refund_trade_no": 570914020383764480, // 鸿闻退款订单号
"refund_out_trade_no": "21551125xx1xxxxxx1421", // 商户退款订单号
"refund_status": "REFUND_FAIL",
"refund_amount": "0.05",
"succeed_time": 0,
"failed_time": 0,
"sign": "vwleKae4uwn/hQPjQNRkCXLVLtj+tZAcX3FTjmEdV2disKx3/mYrUT2+oFlKnNJAEAhWUColZigYZ6288Wt3DElYugsrZTxA0u+0eZoiucGC2XW0FC1pqiEVZZLH33PUZBKIhjqm7gglXiL+5OS8PUii05Hpic/QKqKm9deBGrFdR8XLdweTYxx3Kp5o4e1IdnE3LcXIgxF8WPRQijRM0UKuntlcQjNLUJ0vHwmRYfuVAmBkeQj2ewEcWinTgoXWpxtULVZWb26aGP83iTSqIlUKqhh5ZK/78KNtN64uXrje20nFyjugsW9LMgIwf5EjBB5s+U4T9zyV4XrlxTfZ/Q=="
}
返回状态说明
参数 | 描述 |
---|---|
REFUND_PROCESSING | 处理中 |
REFUND_SUCCESS | 退款成功 |
REFUND_FAIL | 退款失败 |
REFUND_CANCEL | 退款已中断 [ 此状态可理解为退款失败 (退款中的订单,用户可以调用停止退款接口来中断此次退款,状态会变为此状态,目前停止退款接口暂未开放)] |