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
obrigatório
Enum:
application/jsonstring
obrigatório
Bearer authentication format, for example: Bearer {{API Key}}.
Query Parameters
int32
obrigatório
Page number, starting from
1.int32
obrigatório
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[]
obrigatório
Transaction record list.
Ocultar properties
Ocultar properties
string
obrigatório
User account ID.
string
obrigatório
Transaction serial number.
string
obrigatório
Transaction time, Unix timestamp in seconds.
string
obrigatório
Transaction type.
string
obrigatório
Transaction channel.
string
obrigatório
Transaction amount, unit is 1/10000 USD.
string
obrigatório
Wallet balance after the transaction, unit is 1/10000 USD.
string
obrigatório
Transaction note.
string
obrigatório
Transaction status.
string
obrigatório
Transaction voucher or invoice URL.
string
obrigatório
Order type. Values:
recharge, refund.int32
obrigatório
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
}
Última modificação em 10 de agosto de 2026