> ## Documentation Index
> Fetch the complete documentation index at: https://ppio.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询交易流水

## 请求头

<ParamField header="Authorization" type="string" required={true}>
  Bearer 身份验证格式，例如：Bearer \{\{API 密钥}}。
</ParamField>

## 查询参数

<ParamField query="pageNo" type="int32" required={true}>
  页码，从 `1` 开始。
</ParamField>

<ParamField query="pageSize" type="int32" required={true}>
  每页数量。
</ParamField>

<ParamField query="serialNumber" type="string" required={false}>
  交易流水号。
</ParamField>

<ParamField query="transactionTimeStart" type="integer" required={false}>
  交易开始时间，秒级 Unix 时间戳（int64）。
</ParamField>

<ParamField query="transactionTimeEnd" type="integer" required={false}>
  交易结束时间，秒级 Unix 时间戳（int64）。
</ParamField>

<ParamField query="transactionType" type="string" required={false}>
  交易类型。常用值：`recharge`（充值）、`refund`（退款）、`consume`（消费）。
</ParamField>

<ParamField query="transactionChannel" type="string" required={false}>
  交易渠道。常用值：`AliPay`（支付宝）、`WeixinPay`（微信支付）、`PublicRemittance`（对公汇款）。
</ParamField>

<ParamField query="status" type="string" required={false}>
  交易状态。取值：`pending`、`success`、`failed`、`expired`。
</ParamField>

<ParamField query="channel" type="string" required={false}>
  交易渠道过滤参数，与 `transactionChannel` 含义一致，建议优先使用 `transactionChannel`。
</ParamField>

<ParamField query="orderType" type="string" required={false}>
  订单类型。取值：`recharge`（充值）、`refund`（退款）。
</ParamField>

## 响应参数

<ResponseField name="data" type="object[]" required={true}>
  交易流水列表。

  <Expandable title="properties" defaultOpen={true}>
    <ResponseField name="customerId" type="string" required={true}>
      用户账号 ID。
    </ResponseField>

    <ResponseField name="serialNumber" type="string" required={true}>
      交易流水号。
    </ResponseField>

    <ResponseField name="transactionTime" type="string" required={true}>
      交易时间，秒级 Unix 时间戳。
    </ResponseField>

    <ResponseField name="transactionType" type="string" required={true}>
      交易类型。
    </ResponseField>

    <ResponseField name="transactionChannel" type="string" required={true}>
      交易渠道。
    </ResponseField>

    <ResponseField name="transactionAmount" type="string" required={true}>
      交易金额，单位为 1/10000 元。
    </ResponseField>

    <ResponseField name="walletBalance" type="string" required={true}>
      交易后的钱包余额，单位为 1/10000 元。
    </ResponseField>

    <ResponseField name="note" type="string" required={true}>
      交易备注。
    </ResponseField>

    <ResponseField name="state" type="string" required={true}>
      交易状态。
    </ResponseField>

    <ResponseField name="invoiceURL" type="string" required={true}>
      交易凭证或发票地址。
    </ResponseField>

    <ResponseField name="orderType" type="string" required={true}>
      订单类型。取值：`recharge`、`refund`。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="int32" required={true}>
  满足查询条件的交易流水总数。
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url 'https://api.ppio.com/openapi/v1/bill/transaction?pageNo=1&pageSize=20&transactionTimeStart=1764547200&transactionTimeEnd=1767225599' \
    --header 'Authorization: Bearer <API_KEY>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "customerId": "<string>",
        "serialNumber": "<string>",
        "transactionTime": "1764547200",
        "transactionType": "recharge",
        "transactionChannel": "AliPay",
        "transactionAmount": "1000000",
        "walletBalance": "1000000",
        "note": "",
        "state": "success",
        "invoiceURL": "",
        "orderType": "recharge"
      }
    ],
    "total": 1
  }
  ```
</ResponseExample>