Load your billing data via API

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 through 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 the import 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 associated customer ID,

• an issue date,

• a payment status (open, paid, unpaid),

• and a net 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 associated subscriptions

Each invoice must reference an existing subscription and customer in order to be correctly linked in Fincome.

Practical 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.

Point of attention: 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 error and analyzed correctly by the platform.

API technical documentation

Fincome API | Fincome technical documentationdocs.fincome.co

Business case

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 is 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.

🔗 Read the full testimonial: Case study – Fincome API integration at Soeman