CPAY接口文档


退款结果查询接口

退款结果查询

接口描述

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

接口地址

测试 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"
}

页面列表

ITEM_HTML