1.4 接入方发起退款

• 请求地址：https://pay.bilibili.com/payplatform/refund/request
• 说明：只有当errno为0，并且refundStatus是REFUND_CREATE或者REFUND_SUCCESS，表示发起退款成功，至于退款结果是成功还是失败，需要根据回调通知判断。
• 请求方式： http post application/json

入参列表

返回列表

【errno及msg映射】

【data返回体】

返回示例

{
  "errno": 0,
  "msg": "SUCCESS",
  "showMsg": "",
  "data": {
    "txId": 30271051**,
    "orderId": "919188",
    "customerRefundId": "",
    "refundId": "2018090718**",
    "refundStatus": "REFUND_CREATE",
    "refundStatusDesc": "退款中",
    "remainAmount": 0,
    "refundTimes": 1,
    "extData": null
  }
}

1.4.1 接入方调用支付中心退款接口入参notifyUrl生成规则

• 需接入方提供
• 说明：退款请求回调接口
• 请求方式： http get

例：业务 notifyUrl 传入 http://xxx.com/abc , 回调请求地址为 http://xxx.com/abc?msgId=123&msgContent=通知Json字符消息体

notifyUrl 可以自己补充参数， 如 http://xxx.com/abc?axv=1 ，回调会自适应请求地址 http://xxx.com/abc?axv=1&msgId=123&msgContent=支付中心返回的JSON串

退款notifyUrl入参列表

【退款notifyUrl入参msgContent参数列表】

【退款notifyUrl入参msgContent示例】

{
  "customerId": 1,
  "orderId": "30000***",
  "txId": 30271343***,
  "refundCount": 1,
  "payChannel": 2,
  "payChannelId": 2,
  "leftAmount": 0,
  "sign": "50afbb597dc080098b967d061b42f7a9",
  "batchRefundList": [
    {
      "refundNo": "20180907570***",
      "customerRefundId": "",
      "refundStatus": "REFUND_SUCCESS",
      "refundStatusDesc": "退款成功",
      "refundAmount": 3,
      "extData": "",
      "refundEndTime": "2018-09-07 17:16:03"
    }
  ]
}

退款notifyUrl接口需返回业务处理结果，给支付中心返回一个字符串，值如下

• SUCCESS 表示成功
• FAIL 表示失败 支付平台会立即重试
• REPUBLISH 支付平台稍后重试 支付中心明确收到指定返回后，才认为通知成功，否则会重试，业务方需保证该回调接口的幂等性，注意返回值是大写字符串。

注意事项：

1. 此接口由 delaymq 进行通知， delaymq 的通知方式为 GET
2. 支付中心调用接入方接口会回传两个参数msgId 和 msgContent
3. msgContent 存储的Json 字段，未来有可能会新增新的一级字段，且参与签名，验签或解析时应当考虑兼容新增字段。
4. 接入方需要校验 sign 以确保回调信息是来自支付中心的合法回调。签名校验方式如发起支付时的签名方式。
5. 重试策略为 1, 10, 20, 60, 60, 180, 360, 600, 600, 3600, 7200, 7200, 代表回调未得到业务方成功响应后延迟重试时间（秒）
6. JAVA解析示例

JSONObject jsonObject = JSONObject.parseObject(msgContent);
Map<string,string> map = new HashMap<>();
for(string key : jsonObject.keySet()){
    map.put(key, jsonObject.get(key).toString());
}

7. 为了保证安全，msgContent 内容需要进行验参，参见验参方式。注：将 batchRefundList转化为 json 字符串参与验参。
8. 所有回调结构解析，注意最好不要用固定结构体接受验参，避免日后业务需求新增字段后，结构体接收丢失信息，签名校验失败。