Lingxing
切换旧版

回款明细 - ShopeePayout

POST/basicOpen/finance/shopee/payout/list

接口信息

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

请求参数

compareLogicstring
字段比较条件逻辑关系：
AND 所有条件都满足
OR 满足任一条件
默认 AND
currencyCodestring
目标货币代码（为空则使用原币种，切换后按打款时间汇率换算）
endDatestring
结束时间（拨款时间），格式 yyyy-MM-dd，默认当前日期
envKeystring
环境标识
exportFieldsarray<any>
导出字段值
fieldComparesarray<any>
字段比较条件列表（多个条件之间的逻辑关系由 compareLogic 指定）
lengthnumber必填
分页大小，默认 20，最大不超过 200
offsetnumber必填
分页偏移，默认 0
platformCodestring
平台码
searchExactlyboolean
是否精确匹配
searchMultiValuearray<any>
多个搜索值（精确匹配）
searchSingleValuestring
单个搜索值（支持模糊匹配，多个值用逗号分隔）
searchTypestring
搜索类型：
1 付款ID
sidsarray<any>
店铺 ID 数组
sitesarray<any>
站点数组
sortFieldstring
排序字段
sortTypestring
排序方向：
1 升序/ASC
0 降序/DESC
默认 0
startDatestring
开始时间（拨款时间），格式 yyyy-MM-dd，默认当前月份第一天
storeTypenumber
店铺类型：
1 跨境店(CB)

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/finance/shopee/payout/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "compareLogic": "AND",
    "currencyCode": "USD",
    "startDate": "2026-03-01",
    "endDate": "2026-03-17",
    "length": 20,
    "offset": 0,
    "searchType": "1",
    "searchSingleValue": "PAY001",
    "sids": [10001,10002],
    "sites": ["SG","MY"],
    "storeType": 1
}'

返回结果

JSON Object

codenumber必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
示例 []
request_idstring必填
请求链路id
示例 ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035
response_timestring必填
响应时间
示例 2025-10-23 00:47:29
dataobject必填
响应数据
隐藏子属性
totalCountnumber必填
总记录数
示例 2
totalSumobject必填
汇总数据
隐藏子属性
differencestring必填
差额汇总
示例 12.35
fromAmountstring必填
结算金额汇总
示例 980.50
fromCurrencystring必填
结算币种代码
示例 USD
fromCurrencyIconstring必填
结算币种图标
示例 $
payoutAmountstring必填
拨款金额汇总
示例 992.85
payoutCurrencystring必填
拨款币种代码
示例 USD
payoutCurrencyIconstring必填
拨款币种图标
示例 $
settlementAdjustmentTotalstring必填
总调整金额汇总（Adjustment）
示例 52.35
settlementIncomeTotalstring必填
总结算金额汇总（Income）
示例 940.50
settlementTotalstring必填
结算明细总和汇总
示例 992.85
totalCountnumber必填
总记录数
示例 2
listarray<object>必填
列表数据
隐藏子属性
uniqueNostring必填
业务唯一键
示例 SHOPEE-PAYOUT-001
payoutAmountstring必填
拨款金额（拨款币种）
示例 520.30
payoutCurrencyIconstring必填
拨款币种图标
示例 $
settlementAdjustmentTotalstring必填
总调整金额（Adjustment）
示例 20.00
settlementTotalstring必填
结算明细总和（Income + Adjustment）
示例 520.30
fromCurrencyIconstring必填
结算币种图标
示例 $
payoutCurrencystring必填
拨款币种
示例 USD
payoutTimestring必填
拨款时间
示例 2026-03-17 12:30:00
settlementIncomeTotalstring必填
总结算金额（Income）
示例 500.30
exchangeRatestring必填
汇率
示例 1.0000
payServicestring必填
收款渠道
示例 Payoneer
storeNamestring必填
店铺名
示例 Shopee-SG
fromCurrencystring必填
结算币种
示例 USD
idnumber必填
主键 ID
示例 1001
payeeIdnumber必填
付款ID
示例 99887766
originalPayoutTimenumber必填
原始拨款时间戳
示例 1742198400
storeTypenumber必填
店铺类型：1-跨境店(CB)
示例 1
fromAmountstring必填
结算金额（结算币种）
示例 500.30
siteDisplaystring必填
站点中文展示
示例 新加坡
storeIdnumber必填
店铺 ID
示例 10001
encryptedPayoutIdnumber必填
付款加密ID
示例 1234567890
sitestring必填
站点代码
示例 SG
storeTypeDisplaystring必填
店铺类型展示
示例 跨境店
differencestring必填
差额（总拨款金额（结算）-总订单收入-总调整费）
示例 6.20
platformCodestring必填
平台码
示例 shopee

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035",
    "response_time": "2025-10-23 00:47:29",
    "data": {
        "totalCount": 2,
        "totalSum": {
            "difference": "12.35",
            "fromAmount": "980.50",
            "fromCurrency": "USD",
            "fromCurrencyIcon": "$",
            "payoutAmount": "992.85",
            "payoutCurrency": "USD",
            "payoutCurrencyIcon": "$",
            "settlementAdjustmentTotal": "52.35",
            "settlementIncomeTotal": "940.50",
            "settlementTotal": "992.85",
            "totalCount": 2
        },
        "list": [
            {
                "uniqueNo": "SHOPEE-PAYOUT-001",
                "payoutAmount": "520.30",
                "payoutCurrencyIcon": "$",
                "settlementAdjustmentTotal": "20.00",
                "settlementTotal": "520.30",
                "fromCurrencyIcon": "$",
                "payoutCurrency": "USD",
                "payoutTime": "2026-03-17 12:30:00",
                "settlementIncomeTotal": "500.30",
                "exchangeRate": "1.0000",
                "payService": "Payoneer",
                "storeName": "Shopee-SG",
                "fromCurrency": "USD",
                "id": 1001,
                "payeeId": 99887766,
                "originalPayoutTime": 1742198400,
                "storeType": 1,
                "fromAmount": "500.30",
                "siteDisplay": "新加坡",
                "storeId": 10001,
                "encryptedPayoutId": 1234567890,
                "site": "SG",
                "storeTypeDisplay": "跨境店",
                "difference": "6.20",
                "platformCode": "shopee"
            }
        ]
    }
}