Developer & operator reference
Neptlium Documentation
Find the right system boundary, understand the state model, and complete technical work without assuming that a visible route or configured provider is a live financial capability.
Start here
Overview
AvailableUnderstand Neptlium’s public, application, admin and API boundaries.
Getting started
AvailableLearn the concepts that must be clear before integrating with privileged financial workflows.
Authentication
AvailableUnderstand identity, session and principal resolution during the current authentication transition.
Platform contracts
Authorization
AvailableSeparate authenticated identity from resource ownership, policy and financial authority.
Idempotency
AvailableDesign mutation commands so retries do not silently create duplicate financial consequences.
Errors
AvailableTreat unavailable capability, missing durable state and failed verification as explicit failure states.
Audit & evidence
AvailableKeep activity, audit records, provider evidence, ledger state and reconciliation conceptually distinct.
Financial systems
Payments
AvailableProvider evidence and payment-related routes do not establish a live payment product without end-to-end posting and reconciliation.
Treasury
AvailableTreasury concepts cover liquidity, reserves, policy and approvals; the target treasury API is read-only and does not execute transfers.
Reconciliation
AvailableUnderstand why settlement evidence and canonical reconciled financial state are separate.
Webhooks
AvailableVerified provider events require replay protection, durable ingestion and reviewed provider-specific verification.
Current API surface
Document routes that exist. Do not infer live capability from route presence.
The repository’s current API architecture explicitly distinguishes route presence from production readiness. The sample below is intentionally limited to contracts documented as present in the runtime.
GET /health · GET /v1/health
GET /v1/status · GET /v1/version
POST /v1/account/provision · POST /v1/account/onboarding
GET /v1/capital-account/deposit-address · GET /v1/capital-account/balances