curl --request GET \
--url 'https://api.novita.ai/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
}
Basic
Query Transactions
GET
/
openapi
/
v1
/
bill
/
transaction
curl --request GET \
--url 'https://api.novita.ai/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
}
Request Headers
string
requis
Enum:
application/jsonstring
requis
Bearer authentication format, for example: Bearer {{API Key}}.
Query Parameters
int32
requis
Page number, starting from
1.int32
requis
Number of items per page.
string
Transaction serial number.
integer
Transaction start time, Unix timestamp in seconds (int64).
integer
Transaction end time, Unix timestamp in seconds (int64).
string
Transaction type. Common values:
recharge, refund, consume.string
Transaction channel. Common values:
AliPay, WeixinPay, PublicRemittance.string
Transaction status:
pending, success, failed, expired.string
Transaction channel filter. Same as
transactionChannel. Prefer transactionChannel.string
Order type:
recharge, refund.Response Parameters
object[]
requis
Transaction record list.
Masquer properties
Masquer properties
string
requis
User account ID.
string
requis
Transaction serial number.
string
requis
Transaction time, Unix timestamp in seconds.
string
requis
Transaction type.
string
requis
Transaction channel.
string
requis
Transaction amount, unit is 1/10000 USD.
string
requis
Wallet balance after the transaction, unit is 1/10000 USD.
string
requis
Transaction note.
string
requis
Transaction status.
string
requis
Transaction voucher or invoice URL.
string
requis
Order type. Values:
recharge, refund.int32
requis
Total number of transaction records matching the query.
curl --request GET \
--url 'https://api.novita.ai/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
}
Dernière modification le 10 août 2026