Transactions Service

The Transactions Service owns FloatMe’s Plaid integration: bank connections (items), the accounts, balances, transactions, and liabilities mined from them, and Plaid Identity Verification (KYC) sessions. It serves a REST API to FloatMe services and the mobile edge, and publishes account and connection events to EventBridge.

What This Service Owns

Domain Responsibility

Items

Plaid item records: creation, main-account assignment, disconnection, TTL cleanup

Accounts & Balances

Account records and daily balance snapshots refreshed on every mining run

Transactions

Transaction records mined from Plaid, soft-deleted when Plaid retracts them

Webhooks

Plaid webhook intake, signature verification, and per-item webhook history

Institutions

Plaid institution metadata refreshed weekly

Liabilities

Credit, mortgage, and student-loan records for connected items (mined in test only)

KYC

Plaid Identity Verification sessions and watchlist screening results

Events

Account and connection events published to the EventBridge default bus

Documentation

  • Architecture — System context, component inventory, external dependencies

  • Infrastructure — Lambda config, gateways, tables, queues, streams, schedules, secrets, runtime configuration

  • API Specification — Full OpenAPI spec (Swagger UI)

  • DynamoDB Tables — Entity keys, indexes, enums, TTLs, and access patterns for every table

  • Item Lifecycle — Item statuses and every add, update, remove, prequal, Layer, and link-token flow

  • Plaid Mining — Webhook intake, miner routing, pagination, listener, refiner, feeder, institution sync

  • KYC — Identity Verification session statuses and flows

  • Events — EventBridge event contracts published and consumed

  • Feature Flags — GrowthBook flag reference