Float Service
The Float Service is the authority for short-term financial advances ("floats") within the FloatMe platform. It owns the full float lifecycle — from underwriting eligibility and disbursement through scheduled and event-driven collection.
What This Service Owns
| Domain | Responsibility |
|---|---|
Floats |
Float records and lifecycle — creation, status transitions, collections, and payback dates |
Collections |
Scheduled and webhook-driven collection runs with retry logic and distributed locking |
Prenotes |
Zero-dollar ACH verification transactions sent ahead of the due date |
Bypass |
Per-user eligibility requirement overrides with configurable expiration |
Administration |
User bans from float eligibility and QA tooling for automated float creation |
Events |
Float lifecycle events published to EventBridge for downstream consumers |
Documentation
-
Architecture — System context, component inventory, external dependencies
-
Infrastructure — AWS resources: Lambda config, Fargate, queues, schedules, secrets
-
API Specification — Full OpenAPI spec (Swagger UI)
-
PostgreSQL Schema — Float entity column reference
-
DynamoDB Tables — Collection history, locks, bypass, and single-table design
-
Float Lifecycle — Status state machine, payback, bypass, and ban flows
-
Collections Engine — Every collection run: T-1, due date, retry, webhooks, prenotes
-
ACH Processing — Payment callback handling from the Kinesis stream
-
Fraud Detection — Float-creation fraud checks
-
Events — EventBridge event contracts published and consumed
-
Feature Flags — GrowthBook flag reference