RETURN TO SYSTEM DESIGN VAULT (55)BLUEPRINT #47 // Hard
#47HardFinTech & Transactional APIs
Design and Implement a Wire Transfer API
ASKED IN INTERVIEWS AT:GoogleCapital OneRevolut
EXECUTIVE SUMMARY & PROBLEM STATEMENT
Design a high-security banking wire transfer API executing funds transfers between accounts with strict ACID guarantees, balance validation, and idempotency.
SCALE ESTIMATION & TRAFFIC ENVELOPE
DAILY ACTIVE USERS / TPS10 Million wire transfers per day, peak 2,000/sec
READ / WRITE TRAFFIC RATIOHigh-integrity transactional writes
5-YEAR STORAGE CAPACITYRelational database with synchronous replication
FUNCTIONAL REQUIREMENTS
- [1]Initiate domestic and international wire transfers
- [2]Validate sender balance and account status
- [3]Generate immutable audit ledger records
NON-FUNCTIONAL REQUIREMENTS
- •Zero double-transfers under network retries
- •Strict linearizability on account balances
- •Full regulatory audit logging
CORE ARCHITECTURAL COMPONENTS
API Gateway with HMAC Signature Verification
Idempotency Filter (Redis)
Core Banking Ledger Engine
SWIFT/ACH Settlement Gateway
Audit Vault
DATA SCHEMA & PERSISTENCE
Accounts (id, balance, version), WireTransfers (id, idempotency_key, from_acc, to_acc, amount, status), Ledger (id, entry_type, acc_id, amount)
DISTRIBUTED TRADE-OFFS & FAILURE MODES
- ⟡Double-entry ledger (every debit must have an equal credit) ensures accounts can never generate phantom money from database race conditions.