接口文档 / 收费接口

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

部分收费示例
收费单应收总金额为 1000 元：
1. 第一次部分收 200 元：needPayFee=1000，amount=200。
2. 第二次部分收 300 元：needPayFee=800，amount=300。
3. 第三次全收 500 元：needPayFee=500，amount=500。

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

请求参数

名称	说明	类型
Path 参数
`chargeSheetId`必填	收费单ID	`string`
Body 参数
`payMode`必填	支付方式 1:现金 2:微信支付 3:阿里云 4:银行卡 7:现金券 8:美团支付 9:口碑支付 10:糯米支付 11:收钱吧 12:点评 13:付呗 14:拉卡拉 15:连连支付 16:有赞零售 17:有赞抵现 18:营销卡项示例：`1` 最小：1	`integer`
`amount`必填	当次支付金额（小数点前最多为12位，小数点后最多4位）示例：`100`	`number`
`needPayFee`可选	收费单剩余需要支付的金额（小数点前最多为12位，小数点后最多4位），部分收费场景该字段必填示例：`1000`	`number`
`expectedOddFee`可选	期望凑整抹零金额（不能小于-1，不能大于1），就算没有开启凑整抹零的开关依然生效！！！，如果是部分收费，只有第一次收费的时候这个值有效。示例：`0.52`	`number`
`operatorId`必填	操作人ID 示例：`00000000000000000000000000000000`	`string`
`comment`可选	备注信息（长度最大为 200 个字符）示例：`来自互联网医院`	`string`

请求示例

json

{
  "payMode": 1,
  "amount": 100,
  "needPayFee": 1000,
  "expectedOddFee": 0.52,
  "operatorId": "00000000000000000000000000000000",
  "comment": "来自互联网医院"
}

响应参数

名称	说明	类型
Body 参数
`data`可选	数据	`object`
`id`必填	收费单ID	`string`
`patientOrderId`必填	就诊单ID	`string`
`status`必填	收费单状态 0:未收费 1:部分收费 2:已收费 3:部分退费 4:已退费示例：`2`	`integer`
`statusName`必填	状态名称示例：`已收费`	`string`
`needPay`必填	收费单总共支付的金额示例：`100`	`number`
`receivedFee`必填	收费单已经收费单的金额示例：`100`	`number`
`error`可选可为空	通用业务错误包装	`object`

响应示例

json

{
  "data": {
    "id": "string",
    "patientOrderId": "string",
    "status": 2,
    "statusName": "已收费",
    "needPay": 100,
    "receivedFee": 100
  },
  "error": null
}

业务失败包装示意

json

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

查看 HTTP 状态与业务码排查