查询余额明细列表

GET 
/openapi/2026-07/shoplazza-payment/balance/details

分页返回指定账户类型（可用、待结算或固定备用金）的余额交易明细。

请求

Query参数

balance_type string
要查询的余额账户类型：
• available: 可用余额（acc_settle）
• pending: 待结算余额（acc_payment）
• fixed_reserve: 固定备用金余额（acc_fixed_reserve）
region string

商家账户所在地区（如 US、HK）。默认使用商家的默认地区

currency string

余额账户的币种代码。默认使用商家的默认币种，且必须与所选地区相匹配

cursor string

分页游标

page_size int32

每页记录数（1-100，默认 10）

trans_type string
按交易事件类型筛选。仅在 balance_type 为 "available" 时生效；当 balance_type 为 "pending" 或 "fixed_reserve" 时该字段被忽略：
• batch_settlement: 已完成支付的批量结算
• funds_reserved: 资金划入滚动或固定备用金
• released_reserve: 备用金释放回可用余额
• return_funds: 退款相关资金退回
• balance_debit: 余额扣减
• pay_in: 入账到可用余额
• adjustment: 人工或系统的余额调整
• payout: 向商家银行账户的打款
• payout_fee: 打款手续费
• active_account_fee: 账户活跃服务费
• withdrawal_exchange_fee: 提现汇兑费
trans_time_min string

筛选在该 Unix 时间及之后发生的交易（如 1730548810）

trans_time_max string

筛选在该 Unix 时间及之前发生的交易（如 1730548810）

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

list object[]

余额交易明细记录列表

Array [

trans_timestring

交易发生的时间（如 2018-11-02T12:30:10Z）

trans_idstring

关联的业务交易 ID

trans_typestring

按结算交易类型筛选：

• payment: 支付结算
• reserve_release: 备用金按计划释放
• chargeback: 拒付扣款
• chargeback_win: 拒付胜诉，资金返还
• refund: 退款结算
• refund_reversal: 退款冲正
• ship_ins_comm_transfer: 运费险佣金转入
• ship_ins_comm_reversal: 运费险佣金转入冲正
• adjustment: 结算调整
• debit_negative_balance: 负余额补扣
• debit_negative_balance_reversal: 负余额补扣冲正

trans_amountstring

交易金额，正值表示入账，负值表示出账

currencystring

交易的币种代码（如 USD、EUR）

balance_beforestring

此交易发生前的账户余额

balance_afterstring

此交易发生后的账户余额

descriptionstring

交易的可读描述说明

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "trans_time": "string",
        "trans_id": "string",
        "trans_type": "string",
        "trans_amount": "string",
        "currency": "string",
        "balance_before": "string",
        "balance_after": "string",
        "description": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}