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

# Les types de comptes FedaPay

FedaPay met à votre disposition plusieurs types de comptes, adaptés aux besoins spécifiques de chaque utilisateur. Que vous soyez une **entreprise**, un **travailleur indépendant**, une **ONG**, une **institution gouvernementale** , que vous gériez une **marketplace** ou que vous soyez un **marchand physique** FedaPay vous offre une solution sur mesure pour encaisser vos paiements en toute simplicité et sécurité, voici un aperçu des options disponibles :

## Compte pour ONG

**Pour qui ?**

Ce compte est conçu pour les Organisations Non Gouvernementales (ONG) et les associations à but non lucratif.

**Pourquoi choisir ce compte ?**

* Aucune limite sur le montant des transactions, que ce soit par opération ou par semaine.
* Adapté aux besoins spécifiques des organisations humanitaires et associatives.

**Documents requis (KYB) :**

* Numéro d’enregistrement de l’ONG/association.

* Récépissé officiel de déclaration d’association/ONG.

* Nom du gérant de l’ONG/association.

* Pièce d’identité du Fondateur / Gérant / Directeur.

* Copie du document d’identité du Fondateur / Gérant / Directeur .

## Compte pour Travailleur Indépendant

**Pour qui ?**

Si vous êtes freelance ou prestataire de services et souhaitez recevoir des paiements en toute simplicité, ce compte est fait pour vous.

**Caractéristiques clés :**

* Limite de **10 transactions par semaine**.
* Montant autorisé par transaction : entre **100 XOF et 300 000 XOF**.

**Documents requis (KYC) :**

* Pièce d’identité du Fondateur / Gérant / Directeur.

* Copie du document d’identité.

* Numéro IFU (Identifiant Fiscal Unique).

* Document justificatif de l’IFU.

## Compte Business

**Pour qui ?**

Les entreprises légalement enregistrées qui souhaitent intégrer des paiements en ligne et gérer leur trésorerie efficacement.

**Pourquoi opter pour ce compte ?**

* Accès à **tous les modes de paiement** disponibles sur FedaPay.
* **Aucune limite** sur le montant des transactions.

**Documents requis (KYB) :**

* RCCM ou numéro d’enregistrement de l’entreprise.
* Document officiel RCCM ou justificatif d’enregistrement.
* Nom du gérant de l’entreprise.
* Pièce d’identité du Fondateur / Gérant / Directeur.
* Copie du document d’identité.
* Numéro IFU.
* Document justificatif de l’IFU.

## Compte pour le Gouvernement

**Pour qui ?**

Ce compte est destiné aux institutions gouvernementales et aux entités administratives.

**Pourquoi choisir ce compte ?**

* Aucune limite sur les transactions.
* Adapté aux opérations financières gouvernementales.

**Documents requis:**

Validation par l’équipe FedaPay.

## Compte TAP & GO

**Pour qui ?**

Marchands utilisant la solution TAP & GO pour accepter des paiements en boutique ou sur site.

**Conditions**

* Acceptation des paiements en présentiel (paiement en boutique).
* Aucune limite sur le nombre et le montant des transactions.
  Possibilité de gestion des sous-comptes et commissions selon le profil.

**Documents requis (KYC digital)**

* RCCM ou numéro d’enregistrement de l’entreprise.(Non obligatoire)
* Document officiel RCCM ou justificatif d’enregistrement (si disponible).
* CIP du Fondateur / Gérant / Directeur.
* Document justificatif du CIP.
* Numéro IFU.
* Document justificatif de l’IFU.
* Nom du gérant de l’entreprise.

## Compte Marketplace

**Pour qui ?**

Ce compte est spécialement conçu pour les plateformes de type **marketplace**, qui connectent vendeurs et acheteurs et qui souhaitent automatiser la gestion des paiements et des commissions.

**Pourquoi choisir ce compte ?**

* Accepte **tous les moyens de paiement** (Mobile Money, cartes bancaires, etc.).
* **Aucune limite** sur le nombre et le montant des transactions.
* Fonctionnalité avancée : **gestion des sous-comptes et des commissions.**

**Documents requis (KYC) :**

* RCCM ou numéro d’enregistrement de l’entreprise.
* Document officiel RCCM ou justificatif d’enregistrement.
* Nom du gérant de l’entreprise.
* Pièce d’identité du Fondateur / Gérant / Directeur.
* Copie du document d’identité.
* Numéro IFU.
* Document justificatif de l’IFU.

**Fonctionnalité des sous-comptes**

Avec un compte **Marketplace**, vous avez la possibilité d’intégrer des **sous-comptes**, permettant de **répartir les paiements automatiquement** entre plusieurs parties.

**Exemple d'utilisation :**

Une marketplace met en relation plusieurs vendeurs. Lorsqu’un client achète un produit, une commission est prélevée pour la plateforme, et le reste du paiement est automatiquement transféré au vendeur concerné.

**Conditions pour activer les sous-comptes :**

* Disposer d’un compte Marketplace validé.
* Avoir au moins un sous-compte associé.

**Comment fonctionne la répartition des paiements ?**

Lorsque vous créez une transaction sur votre marketplace, vous pouvez spécifier comment le montant doit être divisé entre le **compte principal** et les **prestataires de services.**

**Exemple d’une requête API pour la répartition des commissions :**

<CodeGroup>
  ```java Curl theme={null}
  //Remplacez VOTRE_CLE_API_SECRETE par la clé API secrète de votre compte sandbox ou live. Si vous utilisez votre compte live, vous devez remplacer le lien par https://api.fedapay.com/v1/transactions

  curl -X POST \
  https://sandbox-api.fedapay.com/v1/transactions \
  -H 'Authorization: Bearer VOTRE_CLE_API_SECRETE' \
  -H 'Content-Type: application/json' \
  -d '{
        "description" : "Transaction for john.doe@example.com",
        "amount" : 2000,
        "currency" : {"iso" : "XOF"},
        "callback_url" : "https://maplateforme.com/callback",
        "customer" : {
            "firstname" : "John",
            "lastname" : "Doe",
            "email" : "john.doe@example.com",
            "phone_number" : {
                "number" : "+22997808080",
                "country" : "bj"
            }
        },
        "sub_accounts_commisssions": [
          {
            "reference": "acc_xxxxxxxxx",
            "amount": 1500
          }
        ]
      }'
  ```

  ```javascript NodeJs theme={null}
  const { FedaPay, Transaction } = require('fedapay')
    
    /* Remplacez VOTRE_CLE_API par votre véritable clé API */
    FedaPay.setApiKey("VOTRE_CLE_API_SECRETE");
    
    /* Précisez si vous souhaitez exécuter votre requête en mode test ou live */
    FedaPay.setEnvironment('sandbox'); //ou setEnvironment('live');
    
    /* Créer la transaction */
    const transaction = await Transaction.create({
      description: 'Description',
      amount: 2000,
      callback_url: 'https://maplateforme.com/callback',
      currency: {
          iso: 'XOF'
      },
      customer: {
          firstname: 'John',
          lastname: 'Doe',
          email: 'john.doe@example.com',
          phone_number: {
              number: '97808080',
              country: 'BJ'
          }
      },
      sub_accounts_commisssions: [
          {
              reference: 'acc_xxxxxxxxx',
              amount: 1500
          }
      ]
    });
  ```

  ```php PHP theme={null}
  /* Remplacez VOTRE_CLE_API par votre véritable clé API */
    \FedaPay\FedaPay::setApiKey("VOTRE_CLE_API_SECRETE");
    
    /* Précisez si vous souhaitez exécuter votre requête en mode test ou live */
    \FedaPay\FedaPay::setEnvironment('sandbox'); //ou setEnvironment('live');
    
    /* Créer la transaction */
    \FedaPay\Transaction::create(array(
      "description" => "Transaction for john.doe@example.com",
      "amount" => 2000,
      "currency" => ["iso" => "XOF"],
      "callback_url" => "https://maplateforme.com/callback",
      "customer" => [
          "firstname" => "John",
          "lastname" => "Doe",
          "email" => "john.doe@example.com",
          "phone_number" => [
              "number" => "+22997808080",
              "country" => "bj"
          ]
      ],
      "sub_accounts_commisssions" => [
        [
          "reference" => "acc_xxxxxxxxx",
          "amount" => 1500
        ]
      ]
    ));
  ```
</CodeGroup>

Dans cet exemple, **1 500 XOF** seront transférés au sous-compte du prestataire de service **(acc\_xxxxxxxxx)**, tandis que le compte principal **gardera la différence** après déduction des frais de FedaPay.

<Warning>
  **Attention :** Le montant total réparti doit être inférieur au montant de la transaction moins les commissions de FedaPay, sinon la transaction échouera.
</Warning>

**Vérifier une transaction et ses commissions**

Depuis votre **tableau de bord  FedaPay**, vous pouvez suivre toutes les transactions avec répartition de commission en consultant leurs détails.

<Frame>
  <img src="https://res.cloudinary.com/dvilp6td2/image/upload/v1742553992/marketplace-transaction-detail-6b778e19a5754bb058c59c6449761716a9c4db5db99ee4fe875ca19db3450c5c_um1vnv.png" />
</Frame>

**Inviter un prestataire à rejoindre votre Marketplace**

Vous pouvez inviter un prestataire de services à rejoindre votre compte **FedaPay Marketplace** directement depuis votre tableau de bord.

**Étapes pour inviter une entreprise :**

<Steps>
  <Step title="Accédez au 'menu Place de marché' dans votre tableau de bord.">
    <Frame>
      <img src="https://res.cloudinary.com/dvilp6td2/image/upload/v1742554010/dashboard-marketplace-9c9a25e410a79745dc9dd742eb437b57d273dc7754d16fe6833f6ad6f58fe620_knp27w.png" />
    </Frame>
  </Step>

  <Step title="Cliquez sur 'Inviter une entreprise' et remplissez les informations nécessaires.">
    <Frame>
      <img src="https://res.cloudinary.com/dvilp6td2/image/upload/v1742554025/subaccount-invitation-b7982eff6fdeeec0ee01641426fd98b83ce9706a1caec8fffb7801075fa73aa2_hvrfzb.png" />
    </Frame>
  </Step>

  <Step
    title="Une fois l’invitation acceptée, le prestataire pourra recevoir des paiements via votre plateforme et vous pourrez lui verser des commissions.
"
  />
</Steps>

**Automatiser l’ajout de sous-comptes via l’API**

FedaPay permet d’**automatiser** l’ajout de nouveaux prestataires en intégrant la fonctionnalité des sous-comptes directement dans votre système via l’API.

**Exemple de code pour automatiser l'ajout de sous-comptes :**

```java Curl theme={null}
//Remplacez VOTRE_CLE_API_SECRETE par la clé API secrète de votre compte sandbox ou live. Si vous utilisez votre compte live, vous devez remplacer le lien par https://api.fedapay.com/v1/auth/sub_account_invitations

curl -X POST \
  https://sandbox-api.fedapay.com/v1/auth/sub_account_invitations \
  -H 'Authorization: Bearer VOTRE_CLE_API_SECRETE' \
  -H 'Content-Type: application/json' \
  -d '{
        "email" : "john.doe@example.com",
        "full_name" : "Jonh Doe"
      }'
```

FedaPay se charge alors de **vérifier et valider** les informations pour garantir la conformité aux normes KYC.

## Documents contractuels obligatoires

Pour tous les comptes concernés (ONG, Travailleur Indépendant, Business, Marketplace), les documents contractuels suivants sont requis :

* Engagement sur l’honneur
* Conditions générales d’utilisation
* Contrat de prestation de service avec FedaPay

Ces documents sont disponibles en téléchargement sur la plateforme.Ils doivent être :

* téléchargés ;
* signés ;
* scannés ;
* téléversés dans les champs prévus à cet effet.

**Spécificité TAP & GO**

Les documents contractuels sont remplis et signés physiquement sur site lors de l’enrôlement.

## Passage d'un compte individuel à un compte Business sur FedaPay

Si vous possédez un **Compte pour Travailleur Indépendant** (compte individuel), vous pouvez le convertir en **Compte Business** en suivant ces étapes :

<Steps>
  <Step title="Accéder à l’option de mise à niveau">
    * Connectez-vous à votre compte **FedaPay**.
    * Accédez aux paramètres de votre compte.
    * Cliquez sur le bouton **Passer en Business**.
  </Step>

  <Step title="Vérifier les documents requis">
    * Une interface s’affiche avec la liste des documents à fournir pour valider votre compte Business.
    * Assurez-vous d’avoir tous les documents demandés avant de continuer.
  </Step>

  <Step title="Confirmer la conversion">
    * Cliquez sur **Oui, je veux passer en Business**.
    * Remplissez le formulaire de demande en renseignant les informations nécessaires.
  </Step>

  <Step title="Soumettre la demande">
    * Vérifiez que toutes les informations saisies sont correctes.
    * Téléchargez les documents requis.
    * Cliquez sur **Soumettre** pour envoyer votre demande.
  </Step>
</Steps>

## Informations fiscales obligatoires pour les comptes FedaPay

Lorsque vous créez ou mettez à jour un **compte FedaPay** (Travailleur indépendant, Business ou Marketplace), il est nécessaire de fournir les **informations fiscales exactes**, selon votre pays d’opération. Ces données sont nécessaires pour la vérification de votre identité légale et la conformité réglementaire.

**Documents fiscaux requis par pays**

<AccordionGroup>
  <Accordion title="🇧🇯 Bénin">
    **IFU** (Identifiant Fiscal Unique)
  </Accordion>

  <Accordion title="🇸🇳 Sénégal">
    **IFU/NINEA** (Numéro d’Identification Nationale des Entreprises et Associations)
  </Accordion>

  <Accordion title="🇧🇫 Burkina Faso">
    **Identifiant Financier Unique**
  </Accordion>

  <Accordion title="🇨🇮 Côte d’Ivoire">
    **IDU/NIF** (Identifiant Unique / Numéro d’Identification Fiscale)
  </Accordion>

  <Accordion title="🇹🇬 Togo">
    **NIF** (Numéro d’Identification Fiscale)
  </Accordion>

  <Accordion title="🇳🇪 Niger">
    **NIF** (Numéro d’Identification Fiscale)
  </Accordion>

  <Accordion title="🇬🇳 Guinée">
    **NIF** (Numéro d’Identification Fiscale)
  </Accordion>

  <Accordion title="🇲🇱 Mali">
    **NIF** (Numéro d’Identification Fiscale)
  </Accordion>
</AccordionGroup>

<Warning>
  **Assurez-vous que le document fiscal fourni est à jour et au nom exact de l’entité légale concernée.**
</Warning>
