接口文档 / 患者接口

会员卡退款

PUT/api/v2/open-agency/patient/members/{memberCardId}/refund在线调试

请求参数

名称	说明	类型
Path 参数
`memberCardId`必填	会员卡ID 示例：`ffffffff0000000034c1e2173d268002`	`string`
Body 参数
`amount`必填	退款金额示例：`100` 最小：0	`number`
`transactionIds`必填	支付交易ID列表	`array<string>`
`businessId`必填	业务ID 示例：`3808805404481667000`	`string`
`operatorId`可选	操作人ID，系统中的员工ID 示例：`00000000000000000000000000000000`	`string`

请求示例

json

{
  "amount": 100,
  "transactionIds": [
    "string"
  ],
  "businessId": 3808805404481667000,
  "operatorId": "00000000000000000000000000000000"
}

响应参数

名称	说明	类型
Body 参数
`data`可选	数据	`object`
`transactionId`必填	会员卡交易流水ID 示例：`ffffffff0000000034c1e2173d268002`	`string`
`principalBalance`必填	本金余额示例：`200`	`number`
`presentBalance`必填	赠金余额示例：`100`	`number`
`principal`必填	此次扣除本金示例：`100`	`number`
`present`必填	此次扣除赠金示例：`50`	`number`
`businessId`必填	业务ID 示例：`3808805404481667000`	`string`
`error`可选可为空	通用业务错误包装	`object`

响应示例

json

{
  "data": {
    "transactionId": "ffffffff0000000034c1e2173d268002",
    "principalBalance": 200,
    "presentBalance": 100,
    "principal": 100,
    "present": 50,
    "businessId": 3808805404481667000
  },
  "error": null
}

业务失败包装示意

json

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

查看 HTTP 状态与业务码排查