> 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/annexes/glossary.md).

# Glossaire

Termes classés par ordre alphabétique. Quand un terme renvoie à une page dédiée, le lien est indiqué.

## A

**`amount`** Montant brut d'une transaction, hors frais. Toujours en unité entière de la devise (ex : `1000` pour 1 000 XOF).

**`amount_total`** Ce que paie effectivement le client : `amount + fees`. Calculé par Intram à partir des [taux applicables](/payment/fees.md).

**API key** Identifiant numérique de votre compte marchand. Trois clés par environnement :

* `public_key` — identifiant non sensible (équivalent d'un username)
* `private_key` — utilisée par les anciennes intégrations SDK
* `secret_key` — **secret partagé**, sert à signer les requêtes [Merchant API](/merchant-api-v1/authentication.md) et à vérifier les [webhooks signés](/merchant-api-v1/webhooks.md)

## B

**Backend** Vos serveurs (production / staging / dev) qui appellent l'API Intram pour piloter votre compte. Distinct du frontend (navigateur du client).

**Balance / Solde** Montant disponible sur votre wallet. Exposé via [`GET /merchant/balance`](/merchant-api-v1/balance.md). Composé de :

* `available` — disponible pour payouts immédiats
* `pending` — en attente de settlement

## C

**Callback URL** URL fournie au moment d'initier un paiement, vers laquelle Intram redirige le client après le checkout. Différent d'un webhook : c'est une redirection navigateur, pas un appel server-to-server signé.

**CIDR** Notation pour désigner un bloc d'adresses IP. Exemple : `203.0.113.0/24` couvre les 256 IPs de `203.0.113.0` à `203.0.113.255`. Utilisé dans [l'allowlist IP](/merchant-api-v1/sandbox-vs-live.md#la-whitelist-ip-en-mode-live).

**Compte business / Compte marchand** Entité légale enregistrée chez Intram, distincte de votre compte utilisateur. Un utilisateur peut posséder plusieurs comptes business. Voir [Activation du compte marchand](/account/account-activation.md).

**Customer / Client** Le payeur final dans une transaction — la personne dont le wallet ou le compte Mobile Money est débité.

## D

**Dashboard** L'interface web sur <https://app.intram.org> permettant de gérer votre compte : clés API, IPs autorisées, webhooks, transactions, balances, paramètres.

**Devise** Code monétaire ISO 4217. Actuellement supporté : `XOF`. Voir [Devises supportées](/payment/supported-devices.md).

## F

**Fees / Frais** Commissions prélevées sur chaque transaction. Réparties entre **Frais opérateur** (reversés au provider) et **Commission Intram** (conservés par Intram). Voir [Frais](/payment/fees.md).

## G

**Gateway / Gateway URL** Page web servie par Intram (`gateway.intram.org/<transaction_id>`) où le client effectue son paiement. Renvoyée dans `result.gateway_url` après une [demande de paiement](/merchant-api-v1/payment-requests.md).

## H

**HMAC / HMAC-SHA256** Algorithme de signature cryptographique. Vous prouvez l'authenticité d'un message en calculant `HMAC-SHA256(secret, message)` ; le receveur recalcule la même chose et compare. Utilisé pour [signer les requêtes Merchant API](/merchant-api-v1/authentication.md) et [les webhooks sortants](/merchant-api-v1/webhooks.md).

## I

**Idempotency-Key** Header HTTP unique par opération métier, qui permet de retenter une requête sans risque de double exécution. Obligatoire sur toutes les mutations Merchant API, TTL 24 h. Voir [Idempotency](/merchant-api-v1/idempotency.md).

**IP allowlist** Liste d'IPs autorisées à appeler l'API en mode live, par marchand. Configurable depuis le dashboard (**Développeurs → IPs autorisées**). Voir [Sandbox vs Live](/merchant-api-v1/sandbox-vs-live.md).

**ISO 4217** Standard de codification des devises sur 3 lettres (`XOF`, `EUR`, `USD`…).

**ISO 8601** Standard de format des dates : `2026-05-20T10:30:00.000Z`. Utilisé pour le header `X-Timestamp`.

## L

**Live / Mode live** Environnement de production où les transactions touchent l'argent réel. Identifié par les clés `pk_live_…` / `sk_live_…`. Exige une [allowlist IP](/merchant-api-v1/sandbox-vs-live.md) configurée.

## M

**Mobile Money** Moyen de paiement par téléphone, opéré par des opérateurs télécoms ou bancaires. Codes utilisés :

* `MTN_BENIN_229` — MTN Bénin
* `MOOV_AFRICA_BENIN_229` — Moov Africa Bénin
* `SBIN_BENIN_229` — Sirius Bank Bénin

Voir [Devises supportées](/payment/supported-devices.md) pour la liste à jour.

**`msisdn`** Numéro de téléphone international au format E.164 sans le `+`. Exemple : `22961234567` pour le Bénin (indicatif 229).

## O

**Operation** Trace d'une opération asynchrone Merchant API (`payout`, `payment_request`, `refund`). Identifiée par un `operation_id` (`op_…`). Statuts : `queued`, `processing`, `succeeded`, `failed`. Voir [Opérations](/merchant-api-v1/operations.md).

## P

**Payment Link / Intram Direct** Lien de paiement personnalisé que vous générez pour un client, sans qu'il ait à passer par un checkout. Peut être envoyé par SMS, email, ou intégré à un site.

**Payment request** Demande de paiement asynchrone créée via [`POST /merchant/payment-requests`](/merchant-api-v1/payment-requests.md). Génère un `gateway_url` et un QR code à partager au client.

**Payout / Reversement** Sortie d'argent depuis votre wallet vers un compte externe (Mobile Money ou compte bancaire). Voir [Payouts](/merchant-api-v1/payouts.md).

**`pending`**

* Sur une transaction : en attente de confirmation provider/client.
* Sur un solde : reçu mais pas encore disponible pour payout.

**Provider** Fournisseur externe de moyen de paiement (MTN, Moov, SBIN, Stripe…). Intram fait la passerelle entre vous et eux.

## Q

**QR code** Code-barres 2D encodant l'URL du gateway. Permet à un client de scanner et payer depuis son téléphone. Renvoyé dans `result.qr_code` au format data-URL PNG.

## R

**`reference`** Identifiant public d'une transaction ou d'un payout, lisible par l'humain (ex : `AB12CD34EF`).

**Refund / Remboursement** Inverser une transaction (totalement ou partiellement). Voir [Refunds](/merchant-api-v1/refunds.md).

## S

**Sandbox** Environnement de test où aucune somme réelle n'est manipulée. Identifié par les clés `pk_sandbox_…` / `sk_sandbox_…`. Pas de restriction IP. Voir [Sandbox vs Live](/merchant-api-v1/sandbox-vs-live.md).

**`secret_key`** Clé secrète de votre compte. Sert à calculer la signature HMAC des requêtes Merchant API. **Ne sort jamais** d'un environnement sécurisé.

**Frais opérateur** Part des frais reversée au provider du moyen de paiement (MTN, MOOV, SBIN, Stripe…). Voir [Frais](/payment/fees.md).

**Commission Intram** Part des frais conservée par Intram pour le service de plateforme.

**`service_reference`** Identifiant de la transaction côté provider (ex : référence MTN, ID Stripe). Différent du `reference` Intram. Exposé dans les réponses des endpoints transaction.

**Settlement** Le moment où une transaction passe de `PENDING` à `SUCCESS` côté provider, et où l'argent crédite réellement votre wallet.

**Signature** Header `X-Signature: sha256=<hex>` calculé à partir de `(timestamp + method + path + query + body)` et de votre `secret_key`. Anti-tampering + anti-replay. Voir [Authentification](/merchant-api-v1/authentication.md).

## T

**Timestamp** Header `X-Timestamp` en format [ISO 8601](#i) UTC. Rejeté si > 5 minutes d'écart avec l'heure serveur (anti-replay).

**Transaction** Trace d'un paiement reçu par le marchand. Distincte d'un payout (sortant vers Mobile Money ou compte bancaire).

**Trusted proxy** Quand l'application est derrière Nginx, on fait confiance au header `X-Real-IP` qu'il injecte pour résoudre la vraie IP appelante. Contrôlé par la variable d'environnement `MERCHANT_API_TRUSTED_PROXY`.

## U

**Upstream path** Le path que le serveur Node voit après le rewrite Nginx. Pour la [Merchant API](/merchant-api-v1/authentication.md), l'URL publique `https://api.intram.org/v1/payouts` est réécrite en `/api/v1/merchant/payouts` — c'est ce dernier qui est utilisé pour calculer la signature.

## W

**Wallet** Le porte-monnaie virtuel de votre compte marchand chez Intram. Possède un solde par devise et par moyen de paiement. Les soldes sont strictement isolés entre les environnements `sandbox` et `live`.

**Webhook** Notification HTTP signée envoyée par Intram à votre URL configurée quand un événement se produit (ex : payout réussi, refund accepté). Politique de retry exponentiel jusqu'à 5 tentatives. Voir [Recevoir les webhooks](/merchant-api-v1/webhooks.md).

## Voir aussi

* [Troubleshooting](/annexes/troubleshooting.md) — symptômes courants → causes → solutions
* [Merchant API — Overview](/merchant-api-v1/merchant-api.md)
* [API publique de paiement](/api-index.md)


---

# 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/annexes/glossary.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.