Summary Discover how to import your billing data directly into Fincome via the API. Ideal if your billing tool (internal ERP, in-house software, etc.) is not natively connected.
The Fincome API allows you to import and manage the data from your Fincome account. It is accessible from the interface (Settings menu > Developer API), where you can create a secret key for authentication.
By sending your data in JSON format via our dedicated endpoints, you can leverage all Fincome analyses (MRR, ARR, churn, revenue recognition...) as if your data came from a native integration.
This method is particularly useful if:
you manage your invoices in an internal ERP that is not connected,
you want to automate imports without handling files,
or if you are migrating from another billing system.
Key recommendations
Expected format
Data must be sent in standardized JSON, complying with the schema required by Fincome.
Each invoice must contain:
a unique identifier,
the ID of the associated customer,
an issue date,
a payment status (open, paid, unpaid),
and a pre-tax amount.
Make sure to follow standard date formats (ISO 8601) and valid status values.
Endpoints to use
POST /invoices → to create new invoices
POST /subscriptions → to create or update the associated subscriptions
Each invoice must reference an existing subscription and customer in order to be correctly linked within Fincome.
Concrete use case
For example, you can export the monthly invoices from your internal ERP in JSON format, then import them into Fincome via the API.
Your revenue will thus be taken into account in Fincome even if your billing system is not directly connected.
Note: Be sure to respect the mapping of required fields. Each record must include unique identifiers (to avoid duplicates), correctly formatted dates, consistent billed amounts, and statuses that conform to Fincome’s expectations. Correct mapping ensures your data will be imported without errors and analyzed correctly by the platform.
At Soeman, the technical team chose to integrate Fincome via the API in order to simplify the management of financial data and provide management with a reliable, real-time view of its key KPIs: ARR, MRR, churn, retention.
"We chose the API because it's simpler, automated and real-time. It saves us from manual imports via CSV files and allows our solution to automatically transmit the information."
— Samuel Burey, Technical Manager at Soeman
Thanks to this integration, Soeman automated the sending of its data, gained in reliability, and eliminated any manual handling.
A concrete example of the power of the Fincome API for recurring-revenue businesses.
