退款结果查询接口
退款结果查询
接口描述
- 申请退款后如需确认退款状态,可调用此接口进行查询
- 此接口仅支持退款订单的查询,支付订单的查询请调用交易查询接口
接口地址
测试
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"
}