Lingxing
切换旧版

查询TikTok付款总览

POST/basicOpen/multiplatformFinance/tiktok/paymentTotal/list

支持查询系统【多平台】>【结算中心】>【TikTok】>【付款总览】数据，包含页面业务列与对应汇总。

接口信息

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

请求参数

sidsarray<any>
店铺ID列表，不传或空数组查询全部店铺；数组元素为long
timeTypeinteger
时间类型
1：付款发起时间
2：付款完成时间
startDatestring
开始时间，格式yyyy-MM-dd
endDatestring
结束时间，格式yyyy-MM-dd
paymentStatusesarray<any>
付款状态
PAID：已付款
FAILED：付款失败
PROCESSING：处理中
sortFieldstring
排序字段，仅支持页面可排序列
paymentCreateTime：付款发起时间
paymentCompletedTime：付款完成时间
paymentAmount：付款金额（实付）
originalPaymentAmount：付款金额（原始）
exchangeRate：汇率
sortTypestring
排序方向，字符串编码：0降序、1升序
offsetinteger
分页偏移量，默认0
lengthinteger
每页条数，默认20，最大200
searchTypeinteger
搜索类型
1：Payment ID
searchSingleValuestring
模糊匹配内容
精准匹配使用searchMultiValue，与精准数组互斥
searchMultiValuearray<any>
精准匹配内容列表，单条精准也使用数组
最多500个，与模糊内容互斥
searchExactlyboolean
匹配方式，false模糊，true精准
精准时使用searchMultiValue

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatformFinance/tiktok/paymentTotal/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
  "sids": [],
  "timeType": 1,
  "startDate": "2026-08-01",
  "endDate": "2026-09-22",
  "paymentStatuses": [],
  "sortField": "paymentCreateTime",
  "sortType": "0",
  "offset": 0,
  "length": 20
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 "success"
error_detailsarray<any>必填
数据校验失败时的错误详情
示例 []
request_idstring必填
请求链路id
示例 "0123456789abcdef0123456789abcdef"
response_timestring必填
响应时间
示例 "2026-09-22 12:00:00"
dataobject必填
响应数据
示例 {}
隐藏子属性
listarray<object>必填
明细列表
示例 []
隐藏子属性
storeNamestring必填
店铺
示例 "星辰家居美国店"
paymentIdstring必填
Payment ID
示例 "PAYMENTID-20260901-001"
paymentCreateTimestring必填
付款发起时间
示例 "2026-09-21 15:48:22"
paymentCompletedTimestring必填
付款完成时间
示例 "2026-09-21 16:04:25"
paymentStatusstring必填
付款状态
PAID：已付款
FAILED：付款失败
PROCESSING：处理中
示例 "PAID"
paymentAmountnumber必填
付款金额（实付）
示例 3048.84
currencyCodestring必填
付款币种
示例 "USD"
originalPaymentAmountnumber必填
付款金额（原始）
示例 3048.84
originalCurrencyCodestring必填
付款币种（原始）
示例 "USD"
exchangeRatenumber必填
汇率
示例 1
receiptAccountstring必填
收款银行账号
示例 "****1234"
totalCountinteger必填
总记录数
示例 114
totalSumobject必填
汇总数据
示例 {}
隐藏子属性
currencystring必填
汇总币种
示例 "USD"
paymentAmountnumber必填
付款金额（实付）合计
示例 618928.84
originalPaymentAmountnumber必填
付款金额（原始）合计
示例 4175207.05
originalCurrencystring必填
原始汇总币种
示例 "CNY"
totalinteger必填
总记录数
示例 114

返回成功示例

{
  "code": 0,
  "message": "success",
  "error_details": [],
  "request_id": "0123456789abcdef0123456789abcdef",
  "response_time": "2026-09-22 12:00:00",
  "data": {
    "list": [
      {
        "storeName": "星辰家居美国店",
        "paymentId": "PAYMENTID-20260901-001",
        "paymentCreateTime": "2026-09-21 15:48:22",
        "paymentCompletedTime": "2026-09-21 16:04:25",
        "paymentStatus": "PAID",
        "paymentAmount": 3048.84,
        "currencyCode": "USD",
        "originalPaymentAmount": 3048.84,
        "originalCurrencyCode": "USD",
        "exchangeRate": 1.00,
        "receiptAccount": "****1234"
      }
    ],
    "totalCount": 114,
    "totalSum": {
      "currency": "USD",
      "paymentAmount": 618928.84,
      "originalPaymentAmount": 4175207.05,
      "originalCurrency": "CNY"
    }
  },
  "total": 114
}

附加说明

  • 付款总览没有目标币种筛选；付款金额（实付）与付款金额（原始）分别使用对应币种字段。
  • 排序字段仅限参数表中的页面可排序列，严格区分大小写；未显示排序标记的字段不能作为sortField。
  • 排序方向使用字符串"0"（降序）或"1"（升序），默认按paymentCreateTime降序。
  • 单条精准匹配与批量精准匹配均使用数组；最多500个值。模糊内容和精准数组不能同时有值。
  • 返回金额使用十进制数值；空值不等于0。成功示例仅展示结构，未提供的平台字段和费用明细可能为null。

模糊匹配参数片段（与日期等查询条件组合）：

{
  "searchType": 1,
  "searchSingleValue": "ORDER",
  "searchExactly": false
}

单条精准匹配参数片段；批量时向数组添加其他值：

{
  "searchType": 1,
  "searchMultiValue": [
    "ORDER-001"
  ],
  "searchExactly": true
}