Confirma Finance Integrations API
    • Introduction
    • Authentication
    • Environments
    • Data validation
    • Contact information
    • Go Live & Deployment Guide
    • Services
      • Services
      • Invoice Intermediation service
      • Invoice Lifecycle Service
      • Debt Collection Services
      • Accounting integrations
    • Core endpoints
      • Onboarding
        • Introduction to onboarding
        • Create a new client
        • Validate access token
        • Renew access token
      • Invoices
        • Introduction to Invoices
        • Create an invoice
        • Create an Invoice Action
        • Retrieve case details
        • Retrieve distribution Information
      • Payments
        • Introduction to Payments
        • Retrieve Payments
        • Retrieve settlements
      • Accounting
        • Introduction to accounting
        • Invoice
          • Invoice
        • Ledger
          • Ledger
          • Ledger
        • Payment
          • Payment
          • Payment
    Need help?

    Introduction

    Overview#

    Confirma Finance Integration Solutions (CFIS) is a comprehensive API service framework designed to streamline and centralize financial integrations for businesses operating in Finland, Sweden and Norway.
    The framework is composed of multiple specialized service layers, each addressing a distinct area of financial operations — including invoice management, accounting interfaces to major Finnish accounting platforms, and credit information management.
    The Partner API Service is a dedicated module within the CFIS framework, purpose-built for Confirma Software partners and their clients. It provides a secure and structured interface through which authorized partners can manage client onboarding and interact with the broader suite of CFIS services on behalf of their clients.
    Access to the Partner API Service is governed by a layered authentication model: individual clients authenticate using account-scoped API keys, while Confirma Software partners are issued a master key that grants elevated administrative privileges within the module.

    Core modules for integration#

    Partner API has 4 core modules for successful integration
    Onboarding
    Allows the client account generation to our service
    Invoices
    Generation, distribution and payment control of sales invoices.
    Payments
    Allows clients to fetch invoice allocated payments and settlement information from agency
    Accounting
    Ledger and payment management towards accounting system

    Process Overview#

    The following steps outline the standard workflow for integrating with the Partner API Service.
    1
    Onboard a client
    Begin by using the client onboarding endpoint to create a new user account and provision access to the required services. This step establishes the client's credentials and defines the scope of their service access within the CFIS framework.
    2
    Submit invoices
    Once a client is onboarded, use the invoice endpoints to submit invoices to the service. Related invoice data, agency cases, and submission statuses can also be retrieved through the same set of endpoints.
    3
    Retrieve information
    Use the available endpoints to query up-to-date information on invoice distribution, case details, and settlements.

    API Reference#

    The Partner API Service is built on REST principles, featuring resource-oriented URLs, JSON-encoded request bodies, and JSON-encoded responses. All interactions follow standard HTTP response codes, authentication methods, and verbs.

    Environments#

    The service supports both a staging and a production environment. The API key used to authenticate each request determines which environment is active, allowing you to safely develop and test your integration without affecting live data.
    More information about the environments

    Request Scope#

    Each request operates on a single object — bulk updates are not supported. All operations should be performed on an individual resource basis.

    Authentication#

    The Partner API Service authenticates requests using API keys (X-Api-Key) over HTTPS. Unauthenticated requests and calls made over plain HTTP will fail.
    Keep your API key secure and never expose it in publicly accessible environments.
    More information about the authentication

    Versioning#

    API Version: 1.0 — Initial release, published 01.03.2026
    Next
    Authentication
    Built with