获取银行账户交易数据

读取已链接 Plaid 账户的历史银行交易。这些交易由 identity-service 摄取并维护；TGS 以只读方式对外提供。

Auth

使用包含 MANAGE_PAYMENT 的 Fluz 用户 Bearer 访问令牌调用 /api/v1/graphql。这些字段不允许使用基本身份验证（Basic auth）。

Authorization: Bearer <fluz-user-access-token>

获取交易

query GetPlaidBankTransactions($input: PlaidBankTransactionFilterInput) {
  getPlaidBankTransactions(input: $input) {
    totalCount
    transactions {
      historicalBankTransactionId
      platformItemId
      bankInstitutionAuthId
      bankAccountId
      transactionId
      transactionStatus
      transactionType
      transactionDate
      amount
      currencyCode
      description
      merchantName
      category
      pending
    }
  }
}

{
  "input": {
    "bankAccountId": "bank-account-id",
    "startDate": "2026-01-01T00:00:00.000Z",
    "endDate": "2026-06-04T23:59:59.999Z",
    "paginate": {
      "limit": 50,
      "offset": 0
    }
  }
}

说明

通过 bankAccountId 和 startDate/endDate 时间窗进行筛选；使用 paginate.limit 和 paginate.offset 对结果分页。
totalCount 反映与筛选条件匹配的总数，用于构建分页。
pending: true 表示尚未完全清算的交易——这些与最近的、未结清的支出相同，会减少用户的可用消费能力（参见 Managing Bank Account Spend Power）。

​Auth

​获取交易

Auth

获取交易