> For the complete documentation index, see [llms.txt](https://docs.intram.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.intram.org/modules/intram-business.md).

# Intram Business

**Intram Business** transforme Intram en mini-CRM commercial. Vous gérez votre **catalogue d'offres** (produits + plans d'abonnement), un **fichier client** dédié, et l'**historique des paiements** liés à chaque client. C'est l'outil pour aller au-delà du paiement ponctuel et structurer votre activité récurrente.

Disponible pour **tous les types de comptes** (Particulier, Auto-entrepreneur, Entreprise, Association).

## Cas d'usage typiques

* **Coach / formateur** — vendre des prestations à l'unité (`product`) ou des packages d'accompagnement à paiements échelonnés (`installments`)
* **École privée hors module Scholar** — facturer des frais de scolarité mensuels (`monthly`)
* **Salle de sport / club** — abonnements mensuels ou annuels avec renouvellement automatique
* **Box / abonnement à la box** — livraisons récurrentes (`weekly`, `monthly`)
* **Logiciel / SaaS** — facturation d'abonnements à votre service
* **Prestations sur devis** — encaissement en plusieurs versements négociés avec le client

## Concepts clés

### Offre (Offering)

Une entrée de votre **catalogue**. Deux types :

| Type          | Description                                   | Exemple                             |
| ------------- | --------------------------------------------- | ----------------------------------- |
| **`product`** | Vente à l'unité, paiement immédiat            | "Pack 10 séances de coaching"       |
| **`plan`**    | Vente récurrente avec calendrier de paiements | "Abonnement mensuel salle de sport" |

### Calendrier (pour les plans)

| `schedule_type` | Comportement                                      |
| --------------- | ------------------------------------------------- |
| `immediate`     | Paiement unique immédiat                          |
| `daily`         | Prélèvement quotidien                             |
| `weekly`        | Prélèvement hebdomadaire                          |
| `monthly`       | Prélèvement mensuel                               |
| `yearly`        | Prélèvement annuel                                |
| `installments`  | Découpage en N échéances (négocié au cas par cas) |

Pour `installments`, vous précisez le nombre d'échéances (minimum 2) — utile pour les ventes en 3, 4 ou 6 fois sans frais.

### Client (MarchandClient)

Une fiche dans votre **carnet client** local. Distincte du compte utilisateur Intram du payeur : un même client peut avoir une fiche chez plusieurs marchands.

Chaque fiche regroupe :

* Coordonnées (nom, email, téléphone)
* Catégorie client (configurable depuis le dashboard)
* Historique de toutes les transactions le concernant
* Solde dû éventuel (ventes non soldées)

### Transaction client (MarchandClientTransaction)

Chaque vente / paiement enregistré est rattaché à un client. Le tableau de bord Business vous montre par client :

* Total dépensé
* Dernière transaction
* Solde restant dû
* Échéances à venir

## Comment ça marche

```
1. Vous créez votre catalogue d'offres depuis le dashboard
   ├── Produits (vente unique)
   └── Plans (abonnement / installments)

2. Vous ajoutez vos clients (fichier local)
   └── Ou ils sont créés automatiquement lors de la première vente

3. Vous facturez :
   ├── via un lien de paiement adossé à l'offre (encaissement online)
   └── via un paiement manuel enregistré (espèces, virement, autre)

4. Le système suit :
   ├── Calendrier des prochaines échéances
   ├── Statuts (à venir / payé / en retard)
   ├── Notifications client (email + SMS)
   └── Solde par client + global
```

## Créer une offre depuis le dashboard

1. Menu **Intram Business → Catalogue → Nouvelle offre**
2. Choisissez le type : **Produit** ou **Plan**
3. Remplissez :
   * **Nom** + description
   * **Prix** (par unité ou par échéance pour les plans)
   * **Image** optionnelle
   * **Catégorie** (organisez votre catalogue)
   * Pour les plans : **type de calendrier** + nombre d'échéances si `installments`
4. Validez — l'offre devient `active` et peut être vendue immédiatement

Les offres peuvent être **archivées** (gardent l'historique des ventes passées sans pouvoir être revendues).

## Gérer vos clients

Menu **Intram Business → Clients** :

* **Liste** des clients avec recherche par nom / email / téléphone
* **Fiche client** : coordonnées, historique des transactions, solde
* **Catégories** : créez vos propres tags (Premium, Particulier, Pro…) pour segmenter
* **Import / export CSV** pour synchroniser avec votre outil habituel

## Suivre vos transactions Business

Menu **Intram Business → Transactions** :

* Liste paginée des paiements (online + enregistrés manuellement)
* Filtre par client, par offre, par statut, par plage de dates
* Détail par transaction : montant, frais, méthode, client, offre liée
* Échéances à venir pour les plans actifs

## Paiements en ligne vs manuels

Intram Business distingue deux origines de paiement :

| Origine               | Comment                                                                                  |         Frais        |
| --------------------- | ---------------------------------------------------------------------------------------- | :------------------: |
| **Paiement en ligne** | Le client paie via un lien généré (Mobile Money, carte)                                  |   ✅ Frais standards  |
| **Paiement manuel**   | Vous enregistrez vous-même un règlement reçu hors plateforme (espèces, virement, chèque) | ❌ Aucun frais Intram |

Les paiements manuels servent à **garder une vue unifiée** de votre compta, sans surcharge.

## Frais

Pour les paiements **en ligne** transitant par Intram Business, les frais suivent le [modèle standard](/payment/fees.md). Les paiements manuels enregistrés ne génèrent aucun frais.

## Intégration API (optionnelle)

Si vous voulez piloter votre catalogue ou recevoir des notifications, deux briques :

### Recevoir les notifications de paiement

Configurez un [webhook](/merchant-api-v1/webhooks.md) abonné à `payment_request.paid` — chaque encaissement Business déclenchera un appel signé vers votre URL.

### Lister vos transactions Business depuis votre backend

[`GET /merchant/transactions?limit=100`](/merchant-api-v1/transactions.md) renvoie l'ensemble des transactions de votre compte. Les transactions issues d'Intram Business sont identifiables par le champ `webhook_data` que vous aurez transmis à la création.

### Rembourser une transaction Business

Utilisez [`POST /merchant/refunds`](/merchant-api-v1/refunds.md) avec la `transaction_reference`. Le refund met à jour automatiquement l'historique du client dans Intram Business.

## Limites

* Soumises aux [limites hebdomadaires de votre type de compte](/account/account-activation.md#comprendre-les-limites-hebdomadaires).
* Nombre d'offres dans le catalogue : illimité.
* Nombre de clients dans le fichier : illimité.
* Plans à `installments` : minimum 2 échéances, pas de maximum théorique.

## Voir aussi

* [Intram Direct](/modules/intram-direct.md) — pour les encaissements ponctuels sans gestion client
* [Activation du compte marchand](/account/account-activation.md) — disponibilité par type de compte
* [Frais](/payment/fees.md)
* [Merchant API — Payment requests](/merchant-api-v1/payment-requests.md) — pour créer un lien de paiement programmatiquement
* [Webhooks signés](/merchant-api-v1/webhooks.md) — pour suivre les paiements en temps réel


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.intram.org/modules/intram-business.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.