7. 粉丝端 API 7.21 糖果交易记录【基础探测通过，待数据联调】

Table of Contents

7.21 糖果交易记录【基础探测通过，待数据联调】

GET /tieup/api/v1/me/candy-transactions

鉴权：需要 Authorization: Bearer <access_token>。

查询参数：

参数 类型 必填 说明
page integer 否 页码，默认 1
page_size integer 否 每页数量，默认 20，最大 100
change_type integer 否 糖果变动类型，见 tieup_user_transaction.change_type：1=充值，2=消费，3=退款，4=系统赠送，5=系统扣减，6=活动奖励，7=其他
business_type string 否 业务类型：candy_recharge、question、follow_up_question、video_call、benefit、adjust

响应字段：

字段 类型 说明
data.items array 当前页糖果流水列表
data.items[].transaction_no string 糖果流水号
data.items[].change_type integer 糖果变动类型：1=充值，2=消费，3=退款，4=系统赠送，5=系统扣减，6=活动奖励，7=其他
data.items[].change_amount string 变动糖果数量，正数入账，负数扣减，固定两位小数
data.items[].balance_before string 变动前糖果余额，固定两位小数
data.items[].balance_after string 变动后糖果余额，固定两位小数
data.items[].business_type string 业务类型：candy_recharge、question、follow_up_question、video_call、benefit、adjust
data.items[].business_id integer/null 关联业务记录 ID；无关联时为 null
data.items[].order_no string/null 关联平台订单号；无关联时为 null
data.items[].recharge_no string/null 关联糖果充值或订阅业务单号；无关联时为 null
data.items[].remark string/null 流水备注
data.items[].created_at string/null 创建时间，格式 YYYY-MM-DD HH:mm:ss
data.pagination.page integer 当前页码
data.pagination.page_size integer 每页数量
data.pagination.total integer 总数量
data.pagination.next_cursor string/null 下一页游标，当前页码分页固定为 null

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "items": [
      {
        "transaction_no": "UT202606101430001234567890",
        "change_type": 1,
        "change_amount": "330.00",
        "balance_before": "1000.00",
        "balance_after": "1330.00",
        "business_type": "candy_recharge",
        "business_id": 100,
        "order_no": "TO202606101430001234567890",
        "recharge_no": "RC202606101430001234567890",
        "remark": "糖果充值到账",
        "created_at": "2026-06-10 14:30:00"
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total": 1,
      "next_cursor": null
    }
  }
}

说明：本接口只查询当前登录用户自己的 tieup_user_transaction 糖果流水。除订阅和糖果充值外，提问、追问、视频通话、福利兑换等付费业务统一通过糖果账户服务扣减和退款，并在本接口返回对应糖果变动记录。