退款结果查询

接口描述

• 申请退款后如需确认退款状态，可调用此接口进行查询
• 此接口仅支持退款订单的查询，支付订单的查询请调用交易查询接口

接口地址

测试 http://xipay.xiangma365.com/api/openpay/v3/queryrefund

正式 http://cpay.xiangma365.com/openpay/v3/queryrefund

请求方式

POST

请求头部

Content-Type:application/json

请求参数

参数	类型	必填	描述	示例
inst_no	string	Y	机构号 ，通道分配	60000001
mch_no	string	Y	商户号	Y52212200002
query_trace_no	string	Y	查询请求流水号	31dafada31dskcada
refund_no	string		退款订单号	20000032114018111516011200013
refund_trace_no	string		退款时的请求流水号	2018116165053
refund_time	string		退款时的请求时间	20191113104923
sign	string	Y	签名字符串	51c7d68424e5492199cf7f4734a2b977

refund_no与refund_trace_no二选其一必填

请求示例

{
   "inst_no": "900024",
    "mch_no": "851906140005",
    "query_trace_no": "df77d158-c882-468a-99b0-980c33427f13",
    "refund_no": "200001165F40191113104923T0002",
    "sign": "932d533354a9aa456de9926b9e046db8"
}

响应参数

参数	类型	必填	描述	示例
return_code	string	Y	业务结果：PAY_SUCCESS退款成功 ，PAY_IN_PROCESS退款中 ，PAY_FAIL退款失败	SUCCESS
return_msg	string	Y	返回信息提示，“退款成功”，“退款申请中”，“参数不合法” 等	退款成功

以下参数在return_code为SUCCESS时返回

参数	类型	必填	描述	示例
result_code	string	Y	业务结果：PAY_SUCCESS退款成功 ，PAY_IN_PROCESS退款中 ，PAY_FAIL退款失败	PAY_SUCCESS
pay_type	string	Y	支付类型：300支付宝，400微信，600云闪付	300
mch_no	string	Y	商户号	851811130002
mch_name	string	Y	商户名称	小猫生活
shop_no	string		门店号	86000033007
shop_name	string		门店名称	小猫生活
query_trace_no	string	Y	查询请求流水号	31dafada31dskcada
refund_trace_no	string	Y	退款时的请求流水号	6a09a206285c
refund_time	string	Y	退款时的请求时间	20191113104923
total_amount	string	Y	订单支付总金额，单位：分	100
refund_amount	string	Y	申请退款金额，单位：分	100
refund_settle	string		实退金额，单位：分，实退金额≤申请退款金额	100
trade_no	string	Y	订单号	20000002814118090716435200001
refund_no	string	Y	退款订单号	20000032114018111516011200013
td_trade_no	string		通道退款订单号
qd_trade_no	string		渠道退款订单号	20191113101416980262
user_id	string		付款方用户id	olKmOs_fIK95vHwIG2pITMN7OYgY
attach	string		扩展字段原样返回	1234
sign	string	Y	签名	336437c53711dd466154c4162cbe1c52

返回示例

{
       "return_code": "SUCCESS",
    "return_msg": "退款成功",
    "result_code": "PAY_SUCCESS",
    "pay_type": "400",
    "mch_name": "TEST聪明付",
    "shop_name": "",
    "mch_no": "851906140005",
    "shop_no": "",
    "query_trace_no": "df77d158-c882-468a-99b0-980c33427f13",
    "refund_trace_no": "b79ffba7-4560-4006-90a2-6a09a206285c",
    "refund_time": "20191113104923",
    "total_amount": "1",
    "refund_amount": "1",
    "refund_settle": "1",
    "trade_no": "200001165F41191113104149T0001",
    "refund_no": "200001165F40191113104923T0002",
    "td_trade_no": null,
    "qd_trade_no": "",
    "user_id": null,
    "attach": "附加字段",
    "sign": "d43d0814e54f586b50b2b7c8ca34f9c4"
}