接口文档 / 收费接口

收费单退款（支持部分退）

只退指定商品
chargeForms 中只传需要退的商品，needRefundFee 和 refundFee 传这些商品的金额总和。

退到不同支付方式
例如全退 100 元，但要退到两个支付方式：
1. 第一次退费时传所有需退商品，传 needRefundFee=100、refundFee=50，退到支付方式 A。此时商品已全部退完，但仍有 50 元未退。
2. 第二次退费不再传商品，传 needRefundFee=0、refundFee=50，退到支付方式 B。

PUT/api/v2/open-agency/charge/{chargeSheetId}/refund在线调试

请求参数

名称	说明	类型
Path 参数
`chargeSheetId`必填	收费单ID	`string`
Body 参数
`operatorId`必填	操作人ID 示例：`00000000000000000000000000000000`	`string`
`needRefundFee`可选	收费项需要退费金额（如果不传默认为收费单的实收金额），最大值为 chargeForms 中商品实收金额总和	`number`
`refundFee`可选	本次退费金额（如果不传默认为收费单的实收金额），最大值为 [needRefundFee] + 欠退金额	`number`
`payMode`可选	支付方式 1:现金 2:微信支付 3:阿里云 4:银行卡 7:现金券 8:美团支付 9:口碑支付 10:糯米支付 11:收钱吧 12:点评 13:付呗 14:拉卡拉 15:连连支付 16:有赞零售 17:有赞抵现 18:营销卡项（如果不传则默认为任意一次收费交易的支付方式）示例：`1` 最小：1	`integer`
`chargeForms`可选	收费form列表，如果需要部分退的场景才传该值	`array<object>`

请求示例

json

{
  "operatorId": "00000000000000000000000000000000",
  "needRefundFee": 0,
  "refundFee": 0,
  "payMode": 1,
  "chargeForms": [
    {
      "id": "00000000000000000000000000000000",
      "chargeFormItems": [
        {
          "id": "00000000000000000000000000000000",
          "unitCount": 1,
          "doseCount": 1
        }
      ]
    }
  ]
}

响应参数

名称	说明	类型
Body 参数
`data`可选	数据	`object`
`id`必填	收费单ID	`string`
`status`必填	收费单状态 0:未收费 1:部分收费 2:已收费 3:部分退费 4:已退费示例：`2`	`integer`
`statusName`必填	状态名称示例：`已收费`	`string`
`refundFee`必填	本次已退金额示例：`10`	`number`
`refundedFee`必填	累积已退金额示例：`20`	`number`
`error`可选可为空	通用业务错误包装	`object`

响应示例

json

{
  "data": {
    "id": "string",
    "status": 2,
    "statusName": "已收费",
    "refundFee": 10,
    "refundedFee": 20
  },
  "error": null
}

业务失败包装示意

json

{
  "data": null,
  "error": {
    "code": 11003,
    "message": "不支持的授权类型{grantType}"
  }
}

查看 HTTP 状态与业务码排查