查询个人账户充值记录

接口路径

GET /api/open/user/topup/self

配额计算说明

amount 为配额变化（内部额度单位），换算成金额（人民币）的方式：

金额(¥) = amount ÷ quota_per_unit × usd_exchange_rate

其中：

• amount：来自本接口返回的 data.items[].amount
• quota_per_unit、usd_exchange_rate、quota_display_type：来自 查询换算参数 接口（GET /api/open/status）

若 quota_display_type = USD（美元），则去掉 × usd_exchange_rate。

说明：money 已是实际支付金额（元），无需再换算。

请求参数

字段	类型	是否必传	说明	限制条件	备注
p	int	否	页码	默认为 1	示例: 1
page_size	int	否	每页条数	默认为 10，最大 100	示例: 20
keyword	string	否	搜索关键词	可选，用于搜索交易号或备注	示例: "trade_123"
record_type	string	否	记录类型过滤	见下文枚举表	示例: "topup"

请求示例

GET 'https://neolink.com/backend/api/open/user/topup/self?p=1&page_size=20'
GET 'https://neolink.com/backend/api/open/user/topup/self?p=1&page_size=20&record_type=redemption'
GET 'https://neolink.com/backend/api/open/user/topup/self?page_size=10&keyword=trade_123'

返回信息

字段	类型	是否必传	说明	备注
success	bool	是	请求是否成功	固定值
message	string	是	错误提示信息（成功时为空）	固定值
data	PagedTopupRecord	是	分页充值记录对象	详见下表

PagedTopupRecord 对象

字段	类型	是否必传	说明	备注
page	int	是	当前页码	从 1 开始
page_size	int	是	每页条数	返回的实际记录数
total	int	是	总记录数	满足条件的充值记录总数
items	[]TopupRecord	是	充值记录数组	详见下表

TopupRecord 对象

字段	类型	是否必传	说明	备注
id	int	是	记录 ID	数据库唯一标识
record_type	string	是	记录类型	"topup"=充值；"deduction"=扣费
trade_no	string	是	交易号	第三方支付交易号
payment_method	string	是	支付方式	"alipay"=支付宝；"wechat"=微信等
amount	int64	是	配额变化	增加/减少的配额数；换算见上文「配额计算说明」
money	float	是	金额	实际支付金额（单位：元）
status	string	是	状态	"success"=成功；"pending"=处理中；"failed"=失败
create_time	int64	是	创建时间	Unix 秒级时间戳
remark	string	是	备注	附加说明

返回示例

成功响应
{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 45,
    "items": [
      {
        "id": 101,
        "record_type": "topup",
        "trade_no": "2026070812345678",
        "payment_method": "alipay",
        "amount": 5000000,
        "money": 500.0,
        "status": "success",
        "create_time": 1752028800,
        "remark": ""
      }
    ]
  }
}