查询结算明细列表

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

分页返回结算明细记录，可按交易类型、币种、地区和结算时间范围过滤。

请求

Query参数

cursor string

分页游标

page_size int32

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

trans_type string
按结算交易类型筛选：
• 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: 负余额补扣冲正
currency string

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

settlement_time_min string

筛选在该 Unix 时间及之后发起的结算记录（如 1730548810）

settlement_time_max string

筛选在该 Unix 时间及之前发起的结算记录（如 1730548810）

region string

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

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

list object[]

结算明细记录列表

Array [

store_idstring

与结算关联的店铺 ID

currencystring

结算账户的货币

trans_typestring

交易类型，参见请求参数中的有效 trans_type 值

trans_idstring

结算的唯一交易 ID

fee_amountstring

与交易关联的费用金额

settlement_amountstring

总结算金额

reserve_amountstring

交易的预留金额

settlement_timestring

结算时间，Unix 时间格式

merchant_idstring

与结算相关的商家 ID

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "list": [
      {
        "store_id": "string",
        "currency": "string",
        "trans_type": "string",
        "trans_id": "string",
        "fee_amount": "string",
        "settlement_amount": "string",
        "reserve_amount": "string",
        "settlement_time": "string",
        "merchant_id": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}