←Back to projects
Rails
Rails is the dedicated virtual account reconciliation infrastructure built on the Nomba API that provides per-customer provisioning, inbound transfer reconciliation, and a clean webhook API for downstream teams.
Accomplishments
- Engineered a 5-state payment reconciliation engine (matched, underpaid, overpaid, misdirected, duplicate) on Nomba virtual accounts, with HMAC-SHA256 webhook verification, idempotent deduplication on transactionId/sessionId, and sub-account–scoped VA provisioning via POST /v1/accounts/virtual/{subAccountId}; validated in production with a live ₦150 Opay transfer reconciled to matched in under 3 seconds end-to-end.
- Built a dual - process architecture(Fastify API + BullMQ worker) that acknowledges Nomba webhooks with HTTP 200 immediately, queues reconciliation asynchronously, and retries failed jobs with 5 - attempt exponential backoff; delivered signed outbound transfer.* events to downstream subscribers with persistent delivery audit logs.
- Developed a multi-tenant REST API (8 endpoints) with SHA-256–hashed API key auth, OpenAPI/Swagger documentation with Bearer authorization, and customer-level ledger APIs (paginated transactions + filterable statements), enabling downstream teams to integrate Nomba VA reconciliation in under one hour without rebuilding webhook or edge-case handling.