退款

退款

对已成功的协议支付原单发起退款，同一 out_refund_no 重复请求按幂等处理。同步受理成功 trade_status 为 PROCESSING，资金终态须通过退款查询或 notify_url 异步通知确认。支持可选分账退款明细 sharing_refund_info_list。

接口说明

请求方式：【POST】/v1/protocol/refund

请求域名：【主域名】https://api.baofu.com

请求参数

Header 参数

Body 参数

sharing_refund_info_list 子项：sharing_merchant_id（分账接收方商户号，必填）、profit_sharing_receiver_amount（该接收方退款金额，单位分，必填）；各子项金额之和宜与 refund_total_amount 一致

请求示例

{
  "out_trade_no": "20260609120001001",
  "out_refund_no": "REF20260622001",
  "refund_total_amount": 100,
  "refund_reason": "用户申请退款",
  "notify_url": "https://merchant.example.com/notify/refund"
}

{
  "out_trade_no": "20260609120001001",
  "out_refund_no": "REF20260622002",
  "refund_total_amount": 100,
  "refund_reason": "用户申请退款",
  "notify_url": "https://merchant.example.com/notify/refund",
  "sharing_refund_info_list": [
    {
      "sharing_merchant_id": "100000363",
      "profit_sharing_receiver_amount": 10
    },
    {
      "sharing_merchant_id": "100000364",
      "profit_sharing_receiver_amount": 90
    }
  ]
}

应答参数

200 OK

应答示例

200 OK

{
  "trade_status": "PROCESSING",
  "trade_status_desc": "处理中",
  "out_trade_no": "20260609120001001",
  "out_refund_no": "REF20260622001",
  "refund_no": "20251218173125013031185289875340",
  "refund_total_amount": 100
}

错误码

公共错误码