Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.finventi.com/llms.txt

Use this file to discover all available pages before exploring further.

Ledger API for managing parties, accounts, payments and transactions. It provides a comprehensive set of endpoints for managing financial operations including:

​
Parties

Create and manage individual and organisation parties that can hold accounts.

​
Accounts

Create and get accounts. Manage their statuses:
  • OPENED - Active account ready for transactions.
  • BLOCKED - Temporarily suspended account.
  • CLOSED - Permanently closed account.

​
Payments

Initiate SEPA payments:
  • SCT - SEPA Credit Transfer
  • SCT_INST - SEPA Instant Credit Transfer

​
Transactions

Execute ledger transactions with postings to move funds between accounts:
  • Customer accounts (CURRENT, HOLDING)
  • Internal clearing accounts (INBOUND, OUTBOUND)
  • Revenue accounts (FEE)
  • Suspense accounts

​
Asynchronous Processing

All create/update operations return 202 Accepted and are processed asynchronously. Pass an Idempotency-Key header to ensure idempotency — the correlationId in the response and webhook events can be used to track requests through the system.

​
Error Handling

All API endpoints return standardized error responses. This guide currently covers general error types. Specific use case errors will be documented in future updates.

​
Common Error Codes

  • 400 Bad Request: Invalid request body or parameters
  • 401 Unauthorized: Invalid or expired bearer token
  • 403 Forbidden: IP address not whitelisted or insufficient permissions
  • 404 Not Found: Resource not found (account, party, etc.)
  • 500 Internal Server Error: System error (contact support)
Last modified on May 11, 2026