查询交易流水

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>'

{
  "data": [
    {
      "customerId": "<string>",
      "serialNumber": "<string>",
      "transactionTime": "1764547200",
      "transactionType": "recharge",
      "transactionChannel": "AliPay",
      "transactionAmount": "1000000",
      "walletBalance": "1000000",
      "note": "",
      "state": "success",
      "invoiceURL": "",
      "orderType": "recharge"
    }
  ],
  "total": 1
}

GET

openapi

bill

transaction

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>'

{
  "data": [
    {
      "customerId": "<string>",
      "serialNumber": "<string>",
      "transactionTime": "1764547200",
      "transactionType": "recharge",
      "transactionChannel": "AliPay",
      "transactionAmount": "1000000",
      "walletBalance": "1000000",
      "note": "",
      "state": "success",
      "invoiceURL": "",
      "orderType": "recharge"
    }
  ],
  "total": 1
}

请求头

Authorization

string

必填

Bearer 身份验证格式，例如：Bearer {{API 密钥}}。

查询参数

pageNo

int32

必填

页码，从 1 开始。

pageSize

int32

必填

每页数量。

serialNumber

string

交易流水号。

transactionTimeStart

integer

交易开始时间，秒级 Unix 时间戳（int64）。

transactionTimeEnd

integer

交易结束时间，秒级 Unix 时间戳（int64）。

transactionType

string

交易类型。常用值：recharge（充值）、refund（退款）、consume（消费）。

transactionChannel

string

交易渠道。常用值：AliPay（支付宝）、WeixinPay（微信支付）、PublicRemittance（对公汇款）。

status

string

交易状态。取值：pending、success、failed、expired。

channel

string

交易渠道过滤参数，与 transactionChannel 含义一致，建议优先使用 transactionChannel。

orderType

string

订单类型。取值：recharge（充值）、refund（退款）。

响应参数

data

object[]

必填

交易流水列表。

隐藏 properties

customerId

string

必填

用户账号 ID。

serialNumber

string

必填

交易流水号。

transactionTime

string

必填

交易时间，秒级 Unix 时间戳。

transactionType

string

必填

交易类型。

transactionChannel

string

必填

交易渠道。

transactionAmount

string

必填

交易金额，单位为 1/10000 元。

walletBalance

string

必填

交易后的钱包余额，单位为 1/10000 元。

note

string

必填

交易备注。

state

string

必填

交易状态。

invoiceURL

string

必填

交易凭证或发票地址。

orderType

string

必填

订单类型。取值：recharge、refund。

total

int32

必填

满足查询条件的交易流水总数。

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>'

{
  "data": [
    {
      "customerId": "<string>",
      "serialNumber": "<string>",
      "transactionTime": "1764547200",
      "transactionType": "recharge",
      "transactionChannel": "AliPay",
      "transactionAmount": "1000000",
      "walletBalance": "1000000",
      "note": "",
      "state": "success",
      "invoiceURL": "",
      "orderType": "recharge"
    }
  ],
  "total": 1
}

最后修改于 2026年6月2日

查询 API Key 账单查询 Quota 列表

账单管理

Quota 管理

预算管理

请求头

查询参数

响应参数

​请求头

​查询参数

​响应参数

请求头

查询参数

响应参数