Lingxing
切换旧版

查询eBay回款明细列表

POST/basicOpen/multiplatformFinance/ebayBill/payout/list

查询结算中心对应页面的列表数据,支持筛选、排序、分页和汇总。

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatformFinance/ebayBill/payout/listHTTPSPOST1

请求参数

sidsarray<any>
店铺ID列表,不传或空数组表示不按店铺筛选;不是枚举
currencyCodestring
目标币种代码,不传或空字符串使用原币种
payoutStatusesarray<any>
支付状态
SUCCEEDED:付款成功
INITIATED:付款中
FAILED:付款失败
OTHER:其他
arrivalStatusesarray<any>
到账状态
1:已到账
2:暂未匹配
timeZoneTypestring
时间筛选时区
MAIN_SITE:香港时间
UTC:UTC时间
UK:英国时间
US_WEST:美西时间
hasDifferenceboolean
差额筛选:true有差额,false无差额;不传、null或空字符串表示全部
startDatestring
账期日期开始日期,格式yyyy-MM-dd;可不传,与页面清空日期时一致
endDatestring
账期日期结束日期,格式yyyy-MM-dd;可不传,与页面清空日期时一致
searchTypeinteger
单据搜索类型
1:Payout ID
2:账户参考号
3:结算组ID
searchSingleValuestring
单据单值搜索内容,与searchMultiValue互斥
searchMultiValuearray<any>
单据批量搜索内容,最多500个;与searchSingleValue互斥
sortFieldstring
排序字段
payoutDate:账期时间
payoutId:Payout ID
payoutStatus:支付状态
amount:结算金额
transactionCount:结算条数
settlementDifference:结算明细差额
lastAttemptedPayoutDate:支付时间
bankPayoutFeeAmount:手续费
payoutReference:关联ID
receiptStatus:到账状态
sortTypestring
排序方向:0降序,1升序
使用字符串编码
fieldComparesarray<object>
金额比较条件,支持页面上的更多筛选
隐藏子属性
fieldstring必填
比较字段
amount:结算金额
operatorstring必填
比较操作符:&gt;、&gt;=、=、&lt;、&lt;=
valuenumber必填
比较金额
offsetinteger
分页偏移量,默认0
lengthinteger
每页条数,默认20,范围1至200

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatformFinance/ebayBill/payout/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
  "sids": [],
  "currencyCode": "",
  "payoutStatuses": [],
  "arrivalStatuses": [],
  "timeZoneType": "MAIN_SITE",
  "hasDifference": "",
  "startDate": "2026-09-01",
  "endDate": "2026-10-22",
  "searchType": 1,
  "searchMultiValue": [],
  "offset": 0,
  "length": 20
}'

返回结果

Json Object

codeinteger必填
状态码,0表示成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
示例 []
request_idstring必填
请求链路ID
示例 example-request-id
response_timestring必填
响应时间
示例 2026-10-22 12:00:00
dataobject必填
响应数据
隐藏子属性
listarray<object>必填
列表数据
隐藏子属性
idinteger必填
主键ID
companyIdinteger必填
公司ID
storeIdinteger必填
店铺ID
storeNamestring必填
店铺
platformCodestring必填
平台编码
sitestring必填
站点
payoutIdstring必填
Payout ID
payoutReferencestring必填
关联ID
settlementGroupIdstring必填
结算组ID
payoutStatusCodestring必填
支付状态编码
payoutStatusstring必填
支付状态
payoutStatusDescstring必填
支付状态说明
receiptStatusCodestring必填
到账状态编码
receiptStatusstring必填
到账状态
receiptStatusDescstring必填
到账状态说明
containsManualReceiptinteger必填
是否包含手工到账记录
canManualArrivalboolean必填
是否可手工标记到账
canCancelArrivalboolean必填
是否可取消到账标记
amountnumber必填
结算金额
currencystring必填
币种
exchangeRatenumber必填
汇率
convertedToValuenumber必填
换算金额
convertedToCurrencystring必填
换算币种
currencyIconstring必填
币种符号
payoutDatestring必填
账期时间
timeZonestring必填
时区
lastAttemptedPayoutDatestring必填
支付时间
transactionCountinteger必填
结算条数
settlementDifferencenumber必填
结算明细差额
bankNicknamestring必填
银行账户别名
accountLastFourstring必填
账户参考号
bankReferencestring必填
银行参考号
bankInfostring必填
账户名
paymentInstrumentTypestring必填
支付工具
totalFeeValuenumber必填
费用总额
totalFeeCurrencystring必填
费用币种
totalAmountValuenumber必填
总金额
totalAmountCurrencystring必填
总金额币种
totalFeeDetailsstring必填
费用明细JSON字符串
bankPayoutFeeCurrencystring必填
手续费币种
bankPayoutFeeCurrencyIconstring必填
手续费币种符号
bankPayoutFeeAmountnumber必填
手续费
isDeleteinteger必填
删除标记
uniqueNostring必填
业务唯一键
totalCountinteger必填
总记录数
totalSumobject必填
汇总数据
隐藏子属性
totalCountinteger必填
总记录数
currencystring必填
币种
currencyIconstring必填
币种符号
amountnumber必填
结算金额
transactionCountinteger必填
结算条数
bankPayoutFeeCurrencystring必填
手续费币种
bankPayoutFeeCurrencyIconstring必填
手续费币种符号
bankPayoutFeeAmountnumber必填
手续费
settlementDifferencenumber必填
结算明细差额
totalinteger必填
总记录数,与data.totalCount相同
示例 1

返回成功示例

{
  "code": 0,
  "message": "success",
  "error_details": [],
  "request_id": "example-request-id",
  "response_time": "2026-10-22 12:00:00",
  "data": {
    "list": [
      {
        "id": 1234567890123457,
        "companyId": 1234567890123457,
        "storeId": 1234567890123456,
        "storeName": "Example Store",
        "platformCode": "",
        "site": "",
        "payoutId": "EXAMPLE-001",
        "payoutReference": "",
        "settlementGroupId": "EXAMPLE-001",
        "payoutStatusCode": "",
        "payoutStatus": "",
        "payoutStatusDesc": "",
        "receiptStatusCode": "",
        "receiptStatus": "",
        "receiptStatusDesc": "",
        "containsManualReceipt": 0,
        "canManualArrival": false,
        "canCancelArrival": false,
        "amount": 0,
        "currency": "USD",
        "exchangeRate": 0,
        "convertedToValue": 0,
        "convertedToCurrency": "USD",
        "currencyIcon": "$",
        "payoutDate": "2026-10-22 12:00:00",
        "timeZone": "UTC",
        "lastAttemptedPayoutDate": "2026-10-22 12:00:00",
        "transactionCount": 1,
        "settlementDifference": 0,
        "bankNickname": "",
        "accountLastFour": "",
        "bankReference": "",
        "bankInfo": "",
        "paymentInstrumentType": "",
        "totalFeeValue": 0,
        "totalFeeCurrency": "USD",
        "totalAmountValue": 0,
        "totalAmountCurrency": "USD",
        "totalFeeDetails": "[]",
        "bankPayoutFeeCurrency": "USD",
        "bankPayoutFeeCurrencyIcon": "$",
        "bankPayoutFeeAmount": 0,
        "isDelete": 0,
        "uniqueNo": "EXAMPLE-001"
      }
    ],
    "totalCount": 1,
    "totalSum": {
      "totalCount": 1,
      "currency": "USD",
      "currencyIcon": "$",
      "amount": 0,
      "transactionCount": 1,
      "bankPayoutFeeCurrency": "USD",
      "bankPayoutFeeCurrencyIcon": "$",
      "bankPayoutFeeAmount": 0,
      "settlementDifference": 0
    }
  },
  "total": 1
}

附加说明

  • 店铺ID是业务标识,不是枚举。筛选数组为空时表示不限制对应条件。
  • 排序字段和金额比较条件与页面可用控件一致;排序方向请使用当前接口文档列出的编码。
  • 单值搜索与批量搜索互斥。
  • 响应保留list、totalCount和totalSum,外层total等于data.totalCount。金额字段使用JSON数值;订单号、MSKU等业务编号使用字符串。
  • 示例中的业务标识和金额均为虚构数据。
  • 复现页面默认日期范围时,将startDate设为今天往前90天,endDate设为今天。本接口不自动补充日期。