> 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-direct.md).

# Intram Direct

**Intram Direct** est la solution la plus simple pour commencer à encaisser : vous créez un **lien de paiement** depuis le dashboard, vous le partagez à vos clients (SMS, email, WhatsApp, réseaux sociaux, QR code), et l'argent crédite votre wallet dès qu'ils paient.

Aucun site web, aucun développement requis. Disponible pour **tous les types de comptes** (Particulier, Auto-entrepreneur, Entreprise, Association).

## Cas d'usage typiques

* **Indépendant / freelance** — facturer un client ponctuel sans avoir à installer un système de paiement complet
* **Petit commerce** — partager un lien fixe pour un produit unique (formation, abonnement annuel, ticket d'événement)
* **Collecte de fonds** — récolter des dons pour une association ou un projet
* **Vente sur les réseaux sociaux** — coller le lien dans une bio Instagram, WhatsApp Business ou une story
* **Facturation manuelle** — envoyer un lien personnalisé à un client après accord verbal

## Comment ça marche

1. **Vous créez un lien** depuis le dashboard avec : libellé, prix, description (optionnelle), image (optionnelle), type de paiement
2. **Vous obtenez** une URL courte (`https://gateway.intram.org/<référence>`) et un **QR code** prêts à partager
3. **Votre client ouvre le lien**, voit le détail, choisit son moyen de paiement et règle
4. **L'argent crédite votre wallet** dès la confirmation du provider
5. **Vous êtes notifié** par email + dashboard, et — si vous avez configuré un [webhook](/merchant-api-v1/webhooks.md) — par notification signée

## Créer un lien depuis le dashboard

1. Connectez-vous sur <https://app.intram.org>
2. Menu **Intram Direct → Liens de paiement → Nouveau lien**
3. Remplissez :
   * **Libellé** — nom interne pour vous y retrouver
   * **Prix** — montant fixe à encaisser
   * **Utilité / Description** — ce que voit le client sur la page de paiement
   * **Image** — optionnelle, affichée sur la page (logo produit, photo, etc.)
   * **URL de redirection** — page de votre site où renvoyer le client après paiement (succès)
   * **Type de paiement** — moyens autorisés (Mobile Money, Cartes…)
4. Validez — le lien est généré, accompagné d'un QR code téléchargeable

## Gérer vos liens

Depuis **Intram Direct → Liens de paiement** vous pouvez :

* **Activer / désactiver** un lien sans le supprimer (utile pour les ventes flash)
* **Archiver** un lien obsolète sans perdre l'historique des transactions
* **Voir les statistiques** par lien : nombre de paiements, montant collecté, taux de succès
* **Exporter** la liste des paiements en CSV pour votre comptabilité

## Suivre vos transactions

Menu **Intram Direct → Statistiques** :

* **Revenu total** sur la période choisie
* **Taux de succès** (transactions réussies / tentatives)
* **Liens actifs** vs archivés
* **Filtrage** par lien, par statut, par plage de dates
* **Détail transaction par transaction** avec recherche

Vous pouvez aussi consulter chaque transaction individuelle via [`GET /merchant/transactions/:reference`](/merchant-api-v1/transactions.md) depuis votre backend.

## Frais

Une **surcharge plateforme** s'applique aux transactions encaissées via Intram Direct (en plus des frais standards du moyen de paiement choisi par le client). Elle est déduite du montant net versé au marchand.

Voir [Frais](/payment/fees.md) pour le détail du calcul et vos taux applicables.

## Intégration API (optionnelle)

Si vous voulez **automatiser la création de liens** ou les exposer dans votre propre interface, deux options :

### Option 1 — Créer une transaction one-shot depuis votre backend

Plutôt qu'un lien réutilisable, créez une [demande de paiement à usage unique](/merchant-api-v1/payment-requests.md) via la Merchant API :

```bash
POST /v1/payment-requests
{
  "invoice": {
    "amount": 12000,
    "currency": "XOF",
    "description": "Commande #4521",
    "customer": { "email": "client@example.com" }
  },
  "return_urls": {
    "success": "https://shop.example.com/ok",
    "cancel":  "https://shop.example.com/no"
  }
}
```

Vous obtenez un `gateway_url` à présenter / envoyer au client. Idéal pour les paniers de boutique en ligne.

### Option 2 — Recevoir les notifications de paiement de vos liens existants

Configurez un [webhook](/merchant-api-v1/webhooks.md) avec l'event `payment_request.paid` (et `payment_request.failed`) pour recevoir en temps réel le résultat de chaque paiement réalisé via vos liens Intram Direct.

## Limites

* Soumises aux [limites hebdomadaires de votre type de compte](/account/account-activation.md#comprendre-les-limites-hebdomadaires).
* Un même lien peut servir un nombre **illimité** de paiements (sauf si vous le désactivez).
* La devise par défaut est `XOF` ; voir [Devises supportées](/payment/supported-devices.md) pour les autres.

## Voir aussi

* [Intram Business](/modules/intram-business.md) — pour gérer un vrai catalogue d'offres et des clients récurrents
* [Frais](/payment/fees.md) — comprendre le coût d'une transaction
* [Merchant API — Payment requests](/merchant-api-v1/payment-requests.md) — l'équivalent API d'un lien à usage unique
* [Webhooks signés](/merchant-api-v1/webhooks.md) — recevoir les notifications de paiement


---

# 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-direct.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.