跳到主要内容
版本：202201

查询结算明细列表

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

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

请求​

Query参数

    cursor string

    分页游标。

    limit int32

    A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 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）。

响应​

OK

数据结构
    codestring

    error code

    messagestring

    error message

    data object
    list object[]

    结算明细记录列表。

  • Array [
    • store_idstring

    Unique identifier for the store

    currencystring

    Currency of the settlement account

    trans_typestring

    Transaction type, (eg . "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")

    1. payment: Funds received from a completed payment transaction.
    2. reserve_release: Release of funds previously held in reserve.
    3. chargeback: A reversal of funds due to a dispute initiated by the payer.
    4. chargeback_win: Recovered funds from a dispute that was won in favor of the merchant.
    5. refund: Funds returned to the payer due to a refund request.
    6. refund_reversal: Reversal of a previous refund, typically restoring funds to the merchant.
    7. ship_ins_comm_transfer: Transfer of commission fees related to shipping insurance.
    8. ship_ins_comm_reversal: Reversal of previously charged shipping insurance commission.
    9. adjustment: Manual or automatic adjustments to correct balances or transaction amounts.
    10. debit_negative_balance: Debit applied to offset a negative balance on the account.
    11. debit_negative_balance_reversal: Reversal of a previous debit that was applied to correct a negative balance.
    trans_idstring

    Transaction order number, applicable to all transaction types

    fee_amountstring

    Related fee amount

    settlement_amountstring

    Amount settled in this transaction

    reserve_amountstring

    Reserve amount for deposits

    settlement_timestring

    Time when the settlement occurred，(unix timestamp)

    merchant_idstring

    Merchant ID

  • ]
    • has_moreboolean

    是否有更多记录。

    cursorstring

    分页游标。