Skip to content

直接退款

说明:当不需要退分账的情况,可以调用此接口直接退款。

公共参数

参数类型是否必填最大长度描述示例值
mch_noString32商户号2014072300007148
methodString128接口名称trade.apply.refund
charsetString10调用的接口版本,固定为:utf-8utf-8
sign_typeString10商户生成签名字符串所使用的签名算法类型,目前支持 RSARSA 或 rsa
signString344商户请求参数的签名串详见示例
timestampString19发送请求的时间,格式"yyyy-MM-dd HH:mm:ss"2014-07-24 03:07:50
versionString3调用的接口版本,固定为:1.01.0
notify_urlString256异步通知地址,通知退款状态等信息,详见退款回调
return_urlString256不用传,同步跳转地址
biz_contentString业务参数

业务参数

参数类型是否必填最大长度描述示例值
out_trade_noString二选一64商户支付订单号20150320010101001
trade_noString二选一64平台(鸿闻)支付订单号20150320010101002
out_trade_refund_noString64商户退款订单号,唯一202329112001
refund_amountString10退款金额(元)9.98
refund_reasonString128退款原因申请退款的原因

返回信息

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退款已中断 [ 此状态可理解为退款失败 (退款中的订单,用户可以调用停止退款接口来中断此次退款,状态会变为此状态,目前停止退款接口暂未开放)]