跳转到主要内容
GET
List Issuing Balances Transactions

授权

x-auth-token
string
header
必填

由 UQPay 提供的登录 API Token。

请求头

x-on-behalf-of
string

指定代表哪个子账户发起请求。应设置为 account_id,该值可通过 List Connected Accounts 接口获取。若省略或为空,则请求以主账户身份执行。 更多信息参见 关联账户

查询参数

page_size
integer
默认值:10
必填

每页返回的最大条目数。取值范围为 10 - 100,默认为 10。

必填范围: 10 <= x <= 100
page_number
integer
默认值:1
必填

用于获取下一组条目的页码。取值必须大于 1,默认为 1。

必填范围: x >= 1
start_time
string

用于筛选的最早交易创建时间。start_time 与 end_time 之间的最大时间间隔为 90 天。

示例:

"2024-03-21T17:17:32+08:00"

end_time
string

用于筛选的最晚交易创建时间。start_time 与 end_time 之间的最大时间间隔为 90 天。

示例:

"2024-03-21T17:17:32+08:00"

transaction_type
enum<string>

发卡账户余额交易的交易类型筛选。

可用选项:
ISSUING_AUTHORIZATION,
ISSUING_REVERSAL,
ISSUING_REFUND,
CARD_RECHARGE,
CARD_WITHDRAW,
FEE,
DEPOSIT,
TRANSFER_IN,
TRANSFER_OUT,
SETTLEMENT_DEBIT,
SETTLEMENT_CREDIT,
ADJUSTMENT,
FUNDS_TRANSFER_IN,
FUNDS_TRANSFER_OUT,
FEE_REFUND,
FEE_DEDUCTION,
MARGIN_PAYMENT,
MARGIN_REFUND,
OTHER,
SETTLEMENT_REVERSAL,
REFUND
示例:

"DEPOSIT"

transaction_status
enum<string>

发卡账户余额交易的交易状态筛选。

可用选项:
COMPLETED,
PENDING,
FAILED
示例:

"COMPLETED"

currency
string

币种筛选。三位 ISO 4217 货币代码。

示例:

"USD"

transaction_id
string<uuid>

交易 ID 筛选(长 ID)。 交易的唯一标识符。

示例:

"5135e6cc-28b6-4889-81dc-3b86a09e1395"

响应

200 - application/json

成功返回余额交易。

total_pages
integer

可用条目的总页数。

示例:

1

total_items
integer

可用条目的总数。

示例:

10

data
object[]