Documentation

Technical documentation for engineers and operators

Architecture, modules, deployment, API reference and operational guides — everything you need to understand and work with dolfin pay.

High-level overview of dolfin pay's capabilities, positioning and product architecture.

Modular monolith design, domain modules, ports and adapters pattern and data model.

REST API endpoints for authentication, customers, KYC, accounts, payments and more.

Prerequisites, Docker Compose infrastructure, environment configuration and development workflow.

GCP Cloud Run deployment, Cloud SQL setup, CI/CD pipeline and environment management.

KYC state machine, review queue operations, audit logging and evidence pack generation.

Document generation pipeline, statement formats, certificate types and export specifications.

Technical decisions documented with context, alternatives and rationale for every major choice.

Architecture Decision Records

Every major decision, documented

ADR-000

Fineract integration, Kotlin + Spring Boot, PostgreSQL-first, API versioning

ADR-001

Dedicated module for INTERNAL, SEPA and SWIFT beneficiary types

ADR-002

State machine for SEPA payments with screening, submission and settlement

ADR-003

Quote-confirm-execute pattern with TTL and rate provider abstraction

ADR-004

Micrometer metrics, JSON logging, X-Correlation-Id tracing and audit events

ADR-005

Anti-corruption layer for core banking errors with retry strategy

ADR-006

Cloud Run topology, Cloud SQL, Secret Manager and CI/CD pipeline