> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finkare.io/llms.txt
> Use this file to discover all available pages before exploring further.

# API de Recouvrement Intelligent

> Automatisez l'intégralité du cycle de recouvrement avec l'API Finkare : import des factures, orchestration IA multi-canal, paiements et suivi en temps réel.

import { Card, CardGroup } from '/snippets';

## Bienvenue sur l'API Finkare

Finkare est la plateforme de **recouvrement amiable et judiciaire** propulsée par l'intelligence artificielle. Notre API REST vous permet d'intégrer le recouvrement directement dans votre SI existant — ERP, CRM, logiciel de comptabilité.

L'IA orchestre automatiquement les relances multi-canal (email, SMS, LRAR, appels vocaux IA) tout en garantissant le **strict respect des contraintes légales anti-harcèlement** (CPCE, RGPD).

<CardGroup cols={2}>
  <Card title="Import de factures" icon="file-invoice" href="/api-reference/invoices">
    Import unitaire ou en masse (jusqu'à 100 factures par requête). Le workflow de recouvrement démarre automatiquement.
  </Card>

  <Card title="Workflow IA" icon="robot" href="/api-reference/workflow">
    L'IA Mistral orchestre les relances : choix du canal optimal, timing, tonalité progressive. Vous gardez le contrôle (pause, reprise, escalade).
  </Card>

  <Card title="Paiements" icon="credit-card" href="/api-reference/payments">
    Suivi des paiements en temps réel. Liens de paiement générés automatiquement pour chaque débiteur.
  </Card>

  <Card title="Webhooks temps réel" icon="bell" href="/api-reference/webhooks">
    Recevez des notifications instantanées pour chaque événement : paiement reçu, statut modifié, action IA déclenchée. Signés HMAC-SHA256.
  </Card>
</CardGroup>

## Pourquoi Finkare ?

| Fonctionnalité        | Détail                                               |
| --------------------- | ---------------------------------------------------- |
| **IA souveraine**     | Mistral AI (modèle français, inférence en UE)        |
| **Multi-canal**       | Email, SMS, WhatsApp, appels vocaux IA, LRAR         |
| **Conformité légale** | 7 gardes anti-harcèlement intégrés (CPCE)            |
| **RGPD natif**        | Hébergement EU (AWS eu-west), chiffrement AES-256    |
| **API enterprise**    | OAuth 2.1, rate limiting par tier, idempotence       |
| **SDK TypeScript**    | Client officiel avec retry automatique et pagination |

## Premiers pas

<CardGroup cols={3}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Votre première facture en 5 minutes
  </Card>

  <Card title="Authentification" icon="key" href="/authentication">
    API Key ou OAuth 2.1
  </Card>

  <Card title="Référence API" icon="book" href="/api-reference/overview">
    43+ endpoints documentés
  </Card>
</CardGroup>

## Environnements

| Environnement  | Base URL                         | Description                           |
| -------------- | -------------------------------- | ------------------------------------- |
| **Production** | `https://api.finkare.io`         | Données réelles, actions effectives   |
| **Sandbox**    | `https://api-sandbox.finkare.io` | Données de test, aucune action réelle |

Les clés API sont préfixées `fk_live_` en production et `fk_test_` en sandbox.

## Support

* **Email** : [hello@finkare.io](mailto:hello@finkare.io)
* **Statut plateforme** : [status.finkare.io](https://finkare.openstatus.dev)
* **Documentation API interactive** : [api.finkare.io/docs](https://api.finkare.io/docs)