跳转到内容
Teemopay Docs

订单列表

请求地址

methodurl
POST/api/pay/transaction/queryList

头部信息（header）

header 参数入参参数描述
timestamp请求时间戳
nonce随机值
countryKH
app_codeapp 编号

注意事项

  1. 提供近 180 天的实时流水查询。单次查询以一个自然月（如 01 号 00:00:00 至 31 号 23:59:59）为区间。
  2. 对于代付业务，部分国家系统存在“先成功后退款”的可能。处理 queryList 返回的数据时，若 status == 4（退款），应视为该订单资金已发生回冲。请勿将其作为新订单处理，而应关联原业务订单进行状态冲平。

请求参数

字段类型必需长度描述
pageIndexStringno游标：第一页无需传入；非第一页必须传入，用于定位分页起始位置
pageSizeIntegerno查询数量：默认 500，最大 1000
typeStringyes业务类型：PAYIN、PAYOUT，每次仅支持查询一种类型
statusIntegerno状态：1-支付中，2-成功，3-失败，4-退款，5-部分退款
beginTimeStringyes开始时间，格式：yyyy-MM-dd HH:mm:ss.SSS；不得早于当前日期前 90 天或晚于当前时间
endTimeStringyes结束时间，格式：yyyy-MM-dd HH:mm:ss.SSS；查询区间不得超过 31 天
signStringyes签名
请求示例
{
  "pageIndex": "",
  "pageSize": 500,
  "type": "PAYIN",
  "status": 2,
  "beginTime": "2026-03-01 00:00:00.000",
  "endTime": "2026-03-01 23:59:59.999",
  "sign": "YOUR_SIGN"
}
游标请求示例
{
  "pageIndex": "KgntH8WpwV0lKKYXQr8MY1EgdicDUz/V4l8nCk4QRty3",
  "pageSize": 500,
  "type": "PAYIN",
  "status": 2,
  "beginTime": "2026-03-01 00:00:00.000",
  "endTime": "2026-03-01 23:59:59.999",
  "sign": "YOUR_SIGN"
}

返回参数

参数类型必需长度描述
pageIndexStringyes游标
recordsListyes订单列表
- typeStringyes业务类型：PAYIN（代收）、PAYOUT（代付）
- merchantOrderNoStringyes商户单号
- tradeNoStringyes平台单号
- amountStringyes订单原始金额
- transactionAmountStringyes流水实际入账金额（不扣除手续费），失败时为 0.00
- serviceAmountStringyes手续费总额（固定费 + 百分比费）
- statusStringyes状态：1-交易中，2-成功，3-失败，4-退款，5-部分退款
- settleStatusStringyes结算状态：0-未结，1-已结
- createTimeStringyes创建时间，当前国家时区，格式：yyyy-MM-dd HH:mm:ss
- completeTimeStringyes完成时间，当前国家时区，格式：yyyy-MM-dd HH:mm:ss
- settleTimeStringyes结算时间，当前国家时区，格式：yyyy-MM-dd HH:mm:ss
- failReasonStringyes错误原因
- paymentListListyes代收业务专用；当 type=PAYOUT 时返回空数组或不返回
• paymentSingleOrderNoStringyes单次支付通知流水号，用于商户对账关联
• paymentStatementAmountStringyes当次入账金额
• settleTimeStringyes当次结算时间
• settleStatusStringyes当次结算状态：0-未结，1-已结
• completeTimeStringyes当次完成时间
返回示例
{
  "code": 200,
  "data": {
    "records": [
      {
        "type": "PAYIN",
        "merchantOrderNo": "OrderNoExample",
        "tradeNo": "TS2501010001KH0000000000000000",
        "amount": "10000.00",
        "transactionAmount": "10000.00",
        "serviceAmount": "105.00",
        "status": 2,
        "settleStatus": 0,
        "failReason": null,
        "createTime": "2026-03-01 03:00:47",
        "completeTime": "2026-03-01 03:01:08",
        "settleTime": null,
        "paymentList": [
          {
            "paymentSingleOrderNo": "TSOPaymentOrderNoExample",
            "paymentStatementAmount": "10000.00",
            "settleStatus": 0,
            "settleTime": null,
            "completeTime": "2026-03-01 03:01:08"
          }
        ]
      }
    ],
    "pageIndex": "HniK3YZucTudM/kfEpQCLtFVnFaBlcv1K0MG+phCUd2EfYIt"
  },
  "msg": "success",
  "traceId": "8da08d717dbf46a5becdb3776f67640c.113.17773658218864081"
}

错误码

异常码异常信息处理方案
500Business Error请联系我们
600type field invalid parameter valuetype 字段参数值无效
601Data older than 90 days cannot be queried via API. Please use the portal to export historical reports.超过 90 天的数据无法通过 API 查询，请检查 beginTime 字段
602Query range exceeds 31 days. Please query data month by month.查询范围超过 31 天
603The time cannot be later than the current time.时间不能晚于当前时间，请检查 beginTime 字段
604The start time of the application period cannot be later than the end time.开始时间不得晚于结束时间
605status field invalid parameter valuestatus 字段参数值无效
606PageIndex parsing failed游标分页解析失败
错误返回示例
{
  "code": 416,
  "data": null,
  "msg": "Application not found",
  "traceId": "0801113131dd4951a36d19022a31b303.94.17423567008990449"
}