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

# Protocole d'intégration

> Le parcours complet pour devenir partenaire LigdiCash : démarches administratives, formation, intégration technique et mise en production.

Devenir partenaire LigdiCash suit un processus structuré en deux grandes phases : une phase administrative (contrat, KYC) pilotée par votre Partner Manager, puis une phase technique (formation, intégration, tests) encadrée par l'équipe technique LigdiCash.

## Vue d'ensemble

<Steps>
  <Step title="Contact avec le Partner Manager">
    Prenez contact avec l'équipe commerciale LigdiCash. Un **Partner Manager** vous sera assigné — c'est votre interlocuteur pour toute la phase administrative.

    Consultez les [contacts par pays](/ressources/support#contacts-par-pays) pour joindre le Partner Manager de votre région.
  </Step>

  <Step title="KYC — Remplir le KYC et fournir les documents">
    Le Partner Manager vous communiquera la liste complète des documents requis. Vous devrez notamment remplir le **KYC (dossier de connaissance client)** — c'est le KYC LigdiCash. Il comprend entre autres :

    * Le RCCM (Registre du Commerce et du Crédit Mobilier)
    * Le numéro IFU (Identifiant Financier Unique)
    * La fiche descriptive de votre entreprise
    * Tout autre document demandé par le Partner Manager selon votre activité

    <Note>
      La liste exacte des pièces à fournir vous sera communiquée par votre Partner Manager. Elle peut varier selon votre pays et la nature de votre activité.
    </Note>
  </Step>

  <Step title="Négociation des commissions et signature du contrat">
    Votre Partner Manager discute avec vous des conditions tarifaires (commissions par opérateur, par type de transaction). Une fois les conditions validées, vous signez le contrat de partenariat LigdiCash.

    Si vous souhaitez activer les **paiements par carte Visa**, un contrat additionnel spécifique est requis à cette étape. Voir [Activer Visa](/api-paiement/cartes-visa/activation).
  </Step>

  <Step title="Mise en contact avec l'équipe technique">
    Après la signature du contrat, votre Partner Manager vous met en contact avec l'**équipe technique LigdiCash**, qui prend en charge la suite du processus.
  </Step>

  <Step title="Formation dashboard et API">
    L'équipe technique planifie avec vous une **session de formation** couvrant :

    * La prise en main du dashboard LigdiCash
    * Les principes de l'API (endpoints, authentification, flux de paiement, callback)

    Cette formation pose les bases nécessaires avant de commencer l'intégration.
  </Step>

  <Step title="Création du groupe d'intégration Microsoft Teams">
    L'équipe technique crée un **groupe de travail Microsoft Teams** dédié à votre intégration. Ce groupe est votre canal de communication direct avec LigdiCash tout au long de l'intégration et au-delà.

    Dans ce groupe, l'équipe technique vous remet votre **compte d'intégration temporaire** — un compte LigdiCash réel configuré avec les opérateurs de votre contrat, utilisé exclusivement pour vos travaux d'intégration. Voir [Environnements](/concepts/environnements).
  </Step>

  <Step title="Intégration technique">
    Vous réalisez l'intégration avec le compte temporaire fourni. Vous pouvez contacter l'équipe technique à tout moment via le groupe Teams en cas de question ou de blocage.

    Points clés à implémenter et tester :

    * Création de factures et flux de redirection (ou sans redirection selon les opérateurs signés)
    * Réception et traitement du callback
    * Re-vérification du statut avec l'endpoint `confirm`

    <Warning>
      Le callback est l'élément le plus important de l'intégration. Assurez-vous que votre endpoint de callback est accessible depuis internet, qu'il déduplique les requêtes et qu'il appelle `confirm` avant d'honorer une commande. C'est ce point qui sera vérifié en priorité lors des tests de fin d'intégration.
    </Warning>
  </Step>

  <Step title="Tests de fin d'intégration">
    Quand vous estimez votre intégration terminée, signalez-le à l'équipe technique via le groupe Teams. L'équipe planifie alors des **tests de fin d'intégration** pour valider votre implémentation.

    Le point central des tests est le **callback** : l'équipe technique vérifie que votre endpoint reçoit correctement les notifications, les traite de manière idempotente et re-vérifie le statut avec `confirm`.

    Si des ajustements sont nécessaires, l'équipe technique vous accompagne jusqu'à la validation complète.
  </Step>

  <Step title="Signature du PV de fin d'intégration">
    Une fois tous les tests validés, l'équipe technique vous adresse un **PV (procès-verbal) de fin d'intégration**, document numérique à signer en ligne. Ce document atteste que votre intégration est conforme et approuvée.
  </Step>

  <Step title="Passage en production">
    Après la signature du PV, le processus de mise en production se déroule ainsi :

    1. **Vous créez votre propre compte LigdiCash** via l'application mobile LigdiCash ([App Store / Play Store](https://www.ligdicash.com/download)).
    2. **L'équipe technique active votre projet API en production** sur ce compte, avec les opérateurs et les droits prévus par votre contrat.
    3. Vous remplacez les clés du compte d'intégration temporaire par les clés de votre compte de production dans votre configuration.

    <Tip>
      Si vous avez stocké vos clés dans des variables d'environnement dès le début de l'intégration, la bascule en production se limite à changer les valeurs de ces variables. Aucune modification de code n'est nécessaire.
    </Tip>
  </Step>
</Steps>

## Après la mise en production

Le groupe Microsoft Teams reste actif. Il constitue votre canal privilégié pour :

* Contacter l'**équipe support technique** en cas de problème
* Déposer des **réclamations**
* Demander l'activation de nouveaux opérateurs ou fonctionnalités

## Récapitulatif des phases

| Phase           | Pilote                     | Ce que vous faites        |
| --------------- | -------------------------- | ------------------------- |
| Administrative  | Partner Manager            | KYC, contrat, commissions |
| Formation       | Équipe technique           | Dashboard, API            |
| Intégration     | Équipe technique + vous    | Code, tests callback      |
| Validation      | Équipe technique           | Tests finaux, PV          |
| Production      | Équipe technique           | Activer votre projet      |
| Support continu | Équipe technique & support | Groupe Teams              |

## Pages associées

* [Environnements](/concepts/environnements) — compte d'intégration temporaire vs production
* [Authentification](/concepts/authentification) — utiliser vos clés API
* [Sécurisation du callback](/api-paiement/callback/securisation) — ce qui est validé lors des tests finaux